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 毫秒。 這可能會導致經常呼叫 SnmpMgrOpen 和 SnmpMgrClose 之 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 |