SnmpMgrOpen函数初始化通信套接字和数据结构,允许与指定代理进行通信。
LPSNMP_MGR_SESSION SnmpMgrOpen
LPSTR 【lpAgentAddress】, | //目标SNMP代理的名称和地址 |
LPSTR 【lpAgentCommunity】, | //社区为目标SNMP代理 |
INT 【nTimeOut】, | //以毫秒为单位的通信超时 |
INT 【//通讯超时或重试次数】 | //通讯超时或重试次数 |
); |
参数
【lpAgentAddress】
[in]指向一个空值终止的字符串,指定可以解析为IP地址,IPX地址(8.12表示法)或以太网地址的点分十进制IP地址或主机名。
【lpAgentCommunity】
[in]指向以空值终止的字符串,指定与【lpAgentAddress】参数中指定的代理进行通信时使用的SNMP团体名称。
【nTimeOut】
[in]指定通信超时(以毫秒为单位)。
【//通讯超时或重试次数】
[in]指定通信重试计数。每次重试尝试发送时,【nTimeOut】参数中指定的超时会倍增。
返回值
如果函数成功,则返回值是指向LPSNMP_MGR_SESSION结构的指针。这个结构在内部使用,程序员不应该改变它。
如果函数失败,返回值为NULL。要获取扩展错误信息,请调用GetLastError.GetLastError可能会返回SNMP_MEM_ALLOC_ERROR错误代码,表示内存分配错误。
此函数也可能返回Windows Sockets错误代码。
SNMP目标的名称和地址或【lpAgentAddress】参数指向的字符串应符合以下形式之一:
Name/Address | 表格(示例) |
IP地址 | 157.57.8.160 |
IP主机名 | 以太网地址 |
以太网地址 | IPX地址 |
IPX地址 | The Page Setup dialog box lets the user set the following attributes of the printed page: |
备注
只有加载TCP / IP并且名称是TCP / IP主机名,才能为代理提供名称。无法为IPX主机提供NetBIOS名称。
也可以看看