snmpMgrClose 函数 (mgmtapi.h)
[SNMP 可用于“要求”部分中指定的操作系统。 它可能在后续版本中变更或不可用。 请改用 Windows 远程管理,这是 WS-Man 的 Microsoft 实现。]
SnmpMgrClose 函数关闭与指定会话关联的通信套接字和数据结构。 此函数是 SNMP 管理 API 的一个元素。
语法
BOOL SNMP_FUNC_TYPE SnmpMgrClose(
[in] LPSNMP_MGR_SESSION session
);
参数
[in] session
指向指定要关闭的会话的内部结构的指针。 有关更多信息,请参见下面的“备注”部分。
返回值
如果该函数成功,则返回值为非零值。
如果函数失败,则返回值为零。
此函数可能会返回 Windows 套接字错误代码。
注解
Windows Server 2003: SNMP 管理器应用程序可以使用 NULL会话参数调用 SnmpMgrClose,以清理与成功调用 SnmpMgrTrapListen 函数关联的资源。 但请注意,如果应用程序是 DLL,则不应从其 DllMain 入口点函数调用 SnmpMgrClose。
当应用程序 DLL 正在卸载时,不得调用 SnmpMgrClose。
Windows Server 2003:与 Windows 2000 下的相同调用相比,SnmpMgrClose 在 Windows Server 2003 下执行所需的时间更长。 具体而言,在 Windows Server 2003 下,对此 API 的调用最多需要一秒钟才能执行,而在 Windows 2000 下,相同的调用大约需要 0.3 毫秒。 这可能会导致经常调用 SnmpMgrOpen 和 SnmpMgrClose 的 Windows Server 2003 SNMP 应用程序出现性能问题。
若要解决此问题,请在应用程序启动期间通过在本地主机上调用 SnmpMgrOpen 来创建额外的 SNMP 管理器会话,并在应用程序生存期内保持打开状态。 关闭会话管理器将关闭所有关联的会话,只需调用 SnmpMgrClose 一次。
Windows Server 2003 SP1: 上述问题不适用于 Windows 2003 Service Pack 1。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows 2000 Professional [仅限桌面应用] |
最低受支持的服务器 | Windows 2000 Server [仅限桌面应用] |
目标平台 | Windows |
标头 | mgmtapi.h |
Library | Mgmtapi.lib |
DLL | Mgmtapi.dll |