共用方式為


snmpMgrClose 函式 (mgmtapi.h)

[SNMP 可用於需求一節中指定的作業系統。 它在後續版本中可能會變更或無法使用。 請改用 Windows 遠端管理,這是 WS-Man 的 Microsoft 實作。

SnmpMgrClose 函式會關閉與指定會話相關聯的通訊套接字和數據結構。 此函式是SNMP管理 API 的元素。

語法

BOOL SNMP_FUNC_TYPE SnmpMgrClose(
  [in] LPSNMP_MGR_SESSION session
);

參數

[in] session

指定要關閉之工作階段的內部結構指標。 如需詳細資訊,請參閱接下來的<備註>一節。

傳回值

如果函式成功,則傳回非零的值。

如果此函式失敗,則傳回值為零。

此函式可能會傳回 Windows Sockets 錯誤碼。

備註

Windows Server 2003: SNMP 管理員應用程式可以使用 NULL會話參數呼叫 SnmpMgrClose,以清除與成功呼叫 SnmpMgrTrapListen 函式相關聯的資源。 不過請注意,如果您的應用程式是 DLL,它不應該從其 DllMain 進入點函式呼叫 SnmpMgrClose

卸除應用程式 DLL 時,不得呼叫 SnmpMgrClose

Windows Server 2003:相較於 Windows 2000 下的相同呼叫,SnmpMgrClose 需要較長的時間才能在 Windows Server 2003 下執行。 具體而言,此 API 的呼叫最多需要一秒的時間,才能在 Windows Server 2003 下執行,而相同的呼叫大約需要 Windows 2000 下的 .3 毫秒。 這可能會導致經常呼叫 SnmpMgrOpenSnmpMgrClose 之 Windows Server 2003 SNMP 應用程式的效能問題。

若要解決此問題,請在應用程式啟動期間於本機主機上呼叫 SnmpMgrOpen ,並讓它保持開啟狀態,以建立額外的SNMP 管理員會話。 關閉會話管理員將會關閉所有相關聯的會話,而只需要對 SnmpMgrClose 進行一次呼叫。

Windows Server 2003 SP1: 上述問題不適用於 Windows 2003 Service Pack 1。

規格需求

需求
最低支援的用戶端 Windows 2000 專業版 [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平台 Windows
標頭 mgmtapi.h
程式庫 Mgmtapi.lib
Dll Mgmtapi.dll

另請參閱

SNMP 函式

Simple Network Management Protocol (SNMP) 概觀

SnmpMgrOpen

SnmpMgrRequest