Gets information from computers or network
devices through the SNMP protocol.
|
Function |
Group |
Execution |
Windows |
Embedded |
Thin Client |
| SNMPGet
|
System
Info |
Synchronous |
Supported |
Not
supported |
Supported |
Syntax
SNMPGet( strAddress, strCommunity, strOID, "strTagName" )
- strAddress
- The address of the machine/computer (e.g.,
"127.0.0.1" or "localhost" ).
- strCommunity
- SNMP community name when communicating with the
computer (e.g., "public" ).
- strOID
- OID to be consulted (e.g., ".1.3.6.1.2.1.1.1.0" ).
- strTagName
- Name of the tag that will receive the requested
value.
Note: The tag
name must be enclosed in quotes, as shown in the syntax diagram, or
else the project will try to get the value of the named
tag.
Returned value
| Value |
Description |
| 0 |
No error |
| −1 |
Invalid number of parameters |
| −2 |
Invalid parameter |
| −3 |
Cannot connect to the remote machine |
| −4 |
Cannot connect to the remote machine |
| −5 |
GET operation failed |
| −6 |
Invalid OID |
| −7 |
Invalid tag name |
| −8 |
Invalid tag type |
| −9 |
This function is not supported in the current OS |
Examples
|
Tag Name |
Expression |
|
ErrorTag |
SNMPGet( "127.0.0.1", "public",
".1.3.6.1.2.1.1.1.0", "SysDescrTag" ) //ErrorTag will
receive the error code. If the function succeeds, the value in the
OID ".1.3.6.1.2.1.1.1.0" will be saved in the tag SysDescrTag. |