SNMPAPI_CALLBACK回呼函式 (winsnmp.h)
[SNMP 可用於需求一節中指定的作業系統。 它在後續版本中可能會變更或無法使用。 請改用 Windows 遠端管理,這是 WS-Man 的 Microsoft 實作。
Microsoft WinSNMP 實作會呼叫 SNMPAPI_CALLBACK 函式,以通知 WinSNMP 會話 SNMP 訊息或異步事件可供使用。
SNMPAPI_CALLBACK 是應用程式或連結庫定義回呼函式名稱的佔位元元。
語法
SNMPAPI_CALLBACK SnmpapiCallback;
SNMPAPI_STATUS SnmpapiCallback(
[in] HSNMP_SESSION hSession,
[in] HWND hWnd,
[in] UINT wMsg,
[in] WPARAM wParam,
[in] LPARAM lParam,
[in] LPVOID lpClientData
)
{...}
參數
[in] hSession
WinSNMP 會話的句柄。
[in] hWnd
處理 WinSNMP 應用程式的視窗,以在異步要求完成時或發生陷阱通知時通知。 此參數對 WinSNMP 會話沒有意義,但實作一律會將值傳遞至回呼函式。
[in] wMsg
指定不帶正負號的整數,識別要傳送至 WinSNMP 應用程式視窗的通知訊息。 此參數對 WinSNMP 會話沒有意義,但實作一律會將值傳遞至回呼函式。
[in] wParam
指定可識別通知類型的應用程式定義32位值。 如果此參數等於零,會話可以使用SNMP訊息。 應用程式應該呼叫 SnmpRecvMsg 函式來擷取訊息。 如果此參數不等於零,表示會話的異步事件通知。 如需詳細資訊,請參閱下列一節。
[in] lParam
指定應用程式定義的32位值,指定所處理 PDU 的要求識別碼。
[in] lpClientData
如果呼叫此會話的 SnmpCreateSession 函式時,lpClientData 參數不是 NULL,則此參數是應用程式定義數據的指標。
傳回值
函式必須傳回SNMPAPI_SUCCESS,才能繼續執行應用程式。 如果函式傳回任何其他值,則實作會回應,就像應用程式呼叫所指示會話的 SnmpClose 函式一樣。
備註
當實作執行 WinSNMP 應用程式的重新傳輸原則並發生傳輸逾時,實作會通知會話錯誤。 在此情況下, wParam 參數的值會SNMPAPI_TL_TIMEOUT。 如需其他傳輸層錯誤的清單,請參閱 SnmpRegister、 SnmpSendMsg 和 SnmpRecvMsg 函式的參考頁面。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | winsnmp.h |