SNMPAPI_CALLBACK コールバック関数 (winsnmp.h)
[SNMP は、[要件] セクションで指定されたオペレーティング システムで使用できます。 今後のバージョンでは変更されるか、利用できなくなる場合もあります。 代わりに、WS-Man の Microsoft 実装である Windows リモート管理を使用します。
Microsoft WinSNMP 実装は 、SNMPAPI_CALLBACK 関数を呼び出して、SNMP メッセージまたは非同期イベントが使用可能であることを WinSNMP セッションに通知します。
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 関数を呼び出す必要があります。 このパラメーターが 0 と等しくない場合は、セッションの非同期イベント通知を示します。 詳細については、次の「解説」セクションを参照してください。
[in] lParam
処理される PDU の要求 ID を指定するアプリケーション定義の 32 ビット値を指定します。
[in] lpClientData
このセッションの SnmpCreateSession 関数の呼び出しで lpClientData パラメーターが NULL でない場合、このパラメーターはアプリケーション定義データへのポインターです。
戻り値
関数は、アプリケーションの実行を続行するためにSNMPAPI_SUCCESSを返す必要があります。 関数が他の値を返す場合、実装は、アプリケーションが指定されたセッションに対して SnmpClose 関数を呼び出したかのように応答します。
注釈
実装で WinSNMP アプリケーションの再送信ポリシーが実行され、送信タイムアウトが発生すると、その実装によってエラーがセッションに通知されます。 この状況では、 wParam パラメーターの値がSNMPAPI_TL_TIMEOUTされます。 その他のトランスポート層エラーの一覧については、 SnmpRegister、 SnmpSendMsg、および SnmpRecvMsg 関数のリファレンス ページ を 参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | winsnmp.h |