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

另请参阅

SNMP 函数

简单网络管理协议 (SNMP) 概述

SnmpMgrOpen

SnmpMgrRequest