snmpMgrOpen 函式 (mgmtapi.h)
[SNMP 可用於需求一節中指定的作業系統。 它在後續版本中可能會變更或無法使用。 請改用 Windows 遠端管理，這是 WS-Man 的 Microsoft 實作。
SnmpMgrOpen 函式會初始化通訊套接字和數據結構，允許與指定的 SNMP 代理程式進行通訊。 此函式是SNMP管理 API 的元素。
語法
LPSNMP_MGR_SESSION SNMP_FUNC_TYPE SnmpMgrOpen(
[in] LPSTR lpAgentAddress,
[in] LPSTR lpAgentCommunity,
[in] INT nTimeOut,
[in] INT nRetries
);
參數
[in] lpAgentAddress
指定主機名或IP位址之 Null 終止字串的指標。 主機名必須解析為IP位址、8.12表示法中的IPX位址 () 或乙太網路位址。 如需主機名和IP位址可接受的表單，請參閱一節。
[in] lpAgentCommunity
Null 終止字串的指標，指定與 lpAgentAddress 參數所識別之代理程式通訊時要使用的 SNMP 社群名稱。
[in] nTimeOut
指定通訊逾時以毫秒為單位。
[in] nRetries
指定通訊重試計數。 每次傳輸重試嘗試時， nTimeOut 參數中指定的逾時都會加倍。
傳回值
如果函式成功，則傳回值是 LPSNMP_MGR_SESSION 結構的指標。 此結構會在內部使用，程式設計人員不應加以改變。 如需詳細資訊，請參閱接下來的＜備註＞一節。
如果函式失敗，傳回值為 NULL。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。 GetLastError 可能會傳回SNMP_MEM_ALLOC_ERROR錯誤碼，這表示記憶體配置錯誤。
此函式也可能傳回 Windows Sockets 錯誤碼。
備註
可能的話，請使用主機名來識別 lpAgentAddress 參數中的 SNMP 代理程式。 只有在載入 TCP/IP 且名稱為 TCP/IP 主機名時，才能為代理程式提供主機名。 無法為IPX主機提供NetBIOS名稱。
SNMP 目標的名稱和位址，或 lpAgentAddress 參數所指向的字串應該符合下列其中一種形式。
| 名稱/位址 | 表單 (範例) |
|---|---|
| 主機名稱 | merlin 或 merlin.microsoft.com |
| IPv4 位址 | 157.57.8.160 |
| IPv6 位址 | 3ffe：8311：ffff：：b3ff：fe88：c33 |
| MAC 位址 | 00aa00bbccdd |
| IPX 位址 | 00006112.00aa00bbccdd |
應用程式不應該使用此函式所傳回 的LPSNMP_MGR_SESSION 指標，在不同的線程內容中呼叫 SnmpMgrRequest 函式。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限桌面應用程式] |
| 目標平台 | Windows |
| 標頭 | mgmtapi.h |
| 程式庫 | Mgmtapi.lib |
| Dll | Mgmtapi.dll |