SnmpSetRetransmitMode 関数 (winsnmp.h)
[SNMP は、[要件] セクションで指定したオペレーティング システムで使用できます。 今後のバージョンでは変更されるか、利用できなくなる場合もあります。 代わりに、WS-Man の Microsoft 実装である Windows リモート管理を使用します。
WinSNMP SnmpSetRetransmitMode 関数を使用すると、WinSNMP アプリケーションで再送信モードを設定できます。 Microsoft WinSNMP 実装では、新しい再送信モードを使用して、 SnmpSendMsg 関数への後続の呼び出しでの送信タイムアウトと再送信の試行を制御します。
構文
SNMPAPI_STATUS SNMPAPI_CALL SnmpSetRetransmitMode(
[in] smiUINT32 nRetransmitMode
);
パラメーター
[in] nRetransmitMode
新しい再送信モードの値を指定します。 このパラメーターには次のいずれかの値を指定する必要があります。
| 値 | 説明 |
|---|---|
|
実装では、WinSNMP アプリケーションの再送信ポリシーが実行されます。 |
|
実装では、WinSNMP アプリケーションの再送信ポリシーは実行されません。 |
戻り値
関数が成功した場合、戻り値はSNMPAPI_SUCCESS。
関数が失敗した場合、戻り値はSNMPAPI_FAILURE。 拡張エラー情報を取得するには、セッション パラメーターに NULL 値を指定して SnmpGetLastError を呼び出します。 SnmpGetLastError 関数は、次のいずれかのエラーを返すことができます。
| リターン コード | 説明 |
|---|---|
|
SnmpStartup 関数が正常に完了しませんでした。 |
|
メモリ割り当て中にエラーが発生しました。 |
|
実装では、要求された再送信モードはサポートされていません。 |
|
不明または未定義のエラーが発生しました。 |
解説
通常、エージェント アプリケーションではなく WinSNMP マネージャー アプリケーションは、 SnmpSetRetransmitMode 関数を呼び出します。
WinSNMP アプリケーションで再送信モードがSNMPAPI_OFFに設定されている場合、実装では新しい SNMP 通信操作の再送信試行は開始されません。 新しい設定は、WinSNMP アプリケーションが再送信モードをSNMPAPI_ONに戻すまで、 SnmpSendMsg 関数の後続のすべての呼び出しに影響します。
SnmpCancelMsg 関数の呼び出しは、再送信モードが SNMPAPI_OFF に等しい特定の SNMP メッセージに対して SnmpSetRetransmitMode 関数を呼び出すことと同じです。
要件
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | winsnmp.h |
| Library | Wsnmp32.lib |
| [DLL] | Wsnmp32.dll |