共用方式為


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。 如需其他傳輸層錯誤的清單,請參閱 SnmpRegisterSnmpSendMsgSnmpRecvMsg 函式的參考頁面。

規格需求

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

另請參閱

SnmpClose

SnmpCreateSession

WinSNMP 函式

WinSNMP API 概觀