Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
[SNMP is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions. Instead, use Windows Remote Management, which is the Microsoft implementation of WS-Man.]
The return value from a WinSNMP function call can be a handle to a resource that the Microsoft WinSNMP implementation allocates for the WinSNMP application.
The following table lists the five types of resource handles that the implementation allocates.
| Handle type | Description |
|---|---|
| HSNMP_SESSION | Handle to a WinSNMP session |
| HSNMP_ENTITY | Handle to an SNMP entity |
| HSNMP_CONTEXT | Handle to an SNMP context |
| HSNMP_PDU | Handle to a protocol data unit |
| HSNMP_VBL | Handle to a variable binding list |
For more information, see Resource Handle Objects.
The return value can also be an unsigned long integer value of the smiUINT32 type that represents an SNMPAPI_STATUS value.
The following table lists the WinSNMP status values and their meaning.
| Status | Description |
|---|---|
| SNMPAPI_FAILURE | Indicates an error. Equates to 0 or NULL. |
| SNMPAPI_SUCCESS | Indicates the function completed successfully. Equates to 1 or a positive count. |