Platform SDK: Network Management |
The SnmpMgrOpen function initializes communications sockets and data structures, allowing communications with the specified SNMP agent. This function is an element of the SNMP Management API.
LPSNMP_MGR_SESSION SnmpMgrOpen( LPSTR lpAgentAddress, // name and address of target SNMP agent LPSTR lpAgentCommunity, // community for target SNMP agent INT nTimeOut, // communication time-out in milliseconds INT nRetries // communication time-out or retry count );
If the function succeeds, the return value is a pointer to an LPSNMP_MGR_SESSION structure. This structure is used internally and the programmer should not alter it.
If the function fails, the return value is NULL. To get extended error information, call GetLastError. GetLastError may return the SNMP_MEM_ALLOC_ERROR error code, which indicates a memory allocation error.
This function may also return Windows Sockets error codes.
The name and address of the SNMP target, or the string pointed to by the lpAgentAddress parameter, should conform to one of the following forms.
Name/Address | Form (example) |
---|---|
IP Address | 157.57.8.160 |
IP Hostname | merlin.microsoft.com |
Ethernet Address | 00aa00bbccdd |
IPX Address | 00006112.00aa00bbccdd |
Names can be provided for agents only if TCP/IP is loaded and the names are TCP/IP host names. NetBIOS names cannot be supplied for IPX hosts.
Windows NT/2000: Requires Windows NT 3.1 or later.
Windows 95/98: Unsupported.
Header: Declared in Mgmtapi.h.
Library: Use Mgmtapi.lib.
Simple Network Management Protocol (SNMP) Overview, SNMP Functions, SnmpMgrClose, SnmpMgrRequest