ホーム › NetworkManagement.Snmp › SNMPAPI_CALLBACK

SNMPAPI_CALLBACK

コールバック

シグネチャ

DWORD SNMPAPI_CALLBACK(
    INT_PTR hSession,
    HWND hWnd,
    DWORD wMsg,
    WPARAM wParam,
    LPARAM lParam,
    void* lpClientData
);

パラメーター

フィールド	型	説明
hSession	INT_PTR	WinSNMP セッションのハンドルです。
hWnd	HWND	非同期要求が完了したとき、またはトラップ通知が発生したときに通知する、WinSNMP アプリケーションのウィンドウのハンドルです。このパラメーターは WinSNMP セッションにとって意味を持ちませんが、実装は常にこの値をコールバック関数に渡します。
wMsg	DWORD	WinSNMP アプリケーションのウィンドウに送信する通知メッセージを識別する符号なし整数を指定します。このパラメーターは WinSNMP セッションにとって意味を持ちませんが、実装は常にこの値をコールバック関数に渡します。
wParam	WPARAM	通知の種類を識別する、アプリケーション定義の 32 ビット値を指定します。このパラメーターが 0 の場合、そのセッションで SNMP メッセージが利用可能です。アプリケーションは SnmpRecvMsg 関数を呼び出してメッセージを取得してください。このパラメーターが 0 以外の場合は、そのセッションに対する非同期イベント通知を示します。詳細については、後述の「解説」セクションを参照してください。
lParam	LPARAM	処理中の PDU の要求識別子を示す、アプリケーション定義の 32 ビット値を指定します。
lpClientData	void*	このセッションに対する SnmpCreateSession 関数の呼び出しで lpClientData パラメーターが NULL でなかった場合、このパラメーターはアプリケーション定義のデータへのポインターです。

公式ドキュメント

[SNMP は、「要件」セクションに示されたオペレーティングシステムで使用できます。以降のバージョンでは変更されるか、使用できなくなる可能性があります。代わりに、WS-Man の Microsoft 実装である Windows Remote Management を使用してください。]

Microsoft WinSNMP 実装は、SNMP メッセージまたは非同期イベントが利用可能になったことを WinSNMP セッションに通知するために、 SNMPAPI_CALLBACK 関数を呼び出します。

SNMPAPI_CALLBACK は、アプリケーションまたはライブラリが定義するコールバック関数名のプレースホルダーです。

戻り値

アプリケーションの実行を継続するには、この関数は SNMPAPI_SUCCESS を返す必要があります。それ以外の値を返した場合、実装は、対象のセッションに対してアプリケーションが SnmpClose 関数を呼び出した場合と同じように応答します。

解説(Remarks)

実装が WinSNMP アプリケーションの再送ポリシーを実行しているときに送信のタイムアウトが発生すると、実装はそのエラーをセッションに通知します。この場合、wParam パラメーターの値は SNMPAPI_TL_TIMEOUT になります。その他のトランスポート層エラーの一覧については、 SnmpRegister、 SnmpSendMsg、 SnmpRecvMsg の各関数のリファレンスページを参照してください。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)