SnmpMgrTrapListen 函式 (mgmtapi.h)
[SNMP 可用於需求一節中指定的作業系統。 它在後續版本中可能會變更或無法使用。 請改用 Windows 遠端管理，這是 WS-Man 的 Microsoft 實作。
SnmpMgrTrapListen 函式會註冊 SNMP 管理員應用程式從 SNMP 陷阱服務接收 SNMP 陷阱的能力。 此函式是SNMP管理 API 的元素。
語法
BOOL SNMP_FUNC_TYPE SnmpMgrTrapListen(
[out] HANDLE *phTrapAvailable
);
參數
[out] phTrapAvailable
事件句柄的指標，以接收可用的陷阱，而且應用程式應該呼叫 SnmpMgrGetTrap 函式。
傳回值
如果函式成功，則傳回非零的值。
如果此函式失敗，則傳回值為零。 若要取得延伸的錯誤資訊，請呼叫 GetLastError，這可能會傳回下列任何錯誤碼。
| 傳回碼 | Description |
|---|---|
|
表示記憶體配置錯誤。 |
|
表示已經呼叫此函式。 |
|
指出發生一或多個錯誤;無法存取陷阱。 應用程式可以再次嘗試呼叫函式。 |
此函式也可以傳回其他系統錯誤。
備註
請務必注意，對於不是系統管理員的使用者而言，只有在SNMP陷阱服務啟動時， SnmpMgrTrapListen 函式才會成功。
應用程式必須一律呼叫 SnmpMgrTrapListen 函式，才能呼叫 SnmpMgrGetTrap 函式。 這是因為 phTrapAvailable 參數所指向的事件句柄可啟用 SNMP 陷阱的事件驅動取得。 SNMP 管理 API 會在 SNMP 陷阱服務提供陷阱時發出應用程式事件的訊號。
應用程式也可以定期輪詢 SnmpMgrGetTrap 函式中的陷阱。 在此情況下，應用程式應該重複呼叫 SnmpMgrGetTrap ，直到函式傳回零為止。
Windows Server 2003： SNMP 管理員應用程式可以使用 NULL會話參數呼叫 SnmpMgrClose，以清除與成功呼叫 SnmpMgrTrapListen 函式相關聯的資源。 不過請注意，如果您的應用程式是 DLL，它不應該從其 DllMain 進入點函式呼叫 SnmpMgrClose。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | mgmtapi.h |
| 程式庫 | Mgmtapi.lib |
| Dll | Mgmtapi.dll |