SnmpGetTimeout 関数 (winsnmp.h)
[SNMP は、[要件] セクションで指定されたオペレーティング システムで使用できます。 今後のバージョンでは変更されるか、利用できなくなる場合もあります。 代わりに、WS-Man の Microsoft 実装である Windows リモート管理を使用します。
WinSNMP SnmpGetTimeout 関数は、SNMP メッセージ要求を送信するためにタイムアウト値を 1 秒の 100 分の 1 で返します。 タイムアウト値は、WinSNMP アプリケーションが、指定された管理エンティティの SnmpSendMsg 関数に対して行う呼び出しに適用されます。
構文
SNMPAPI_STATUS SNMPAPI_CALL SnmpGetTimeout(
[in] HSNMP_ENTITY hEntity,
[out] smiLPTIMETICKS nPolicyTimeout,
[out] smiLPTIMETICKS nActualTimeout
);
パラメーター
[in] hEntity
対象の宛先管理エンティティを処理します。
[out] nPolicyTimeout
指定した管理エンティティのタイムアウト値を 1 秒の 100 分の 1 で受け取る整数変数へのポインター。 これは、Microsoft WinSNMP 実装がデータベースに格納する値です。 このパラメーターで返される情報が不要な場合、 nPolicyRetry は NULL ポインターである必要があります。
[out] nActualTimeout
実装によって報告された、宛先エンティティの最後の実際の応答間隔または推定応答間隔を受け取る整数変数へのポインター。 このパラメーターで返される情報が不要な場合、 nActualRetry は NULL ポインターである必要があります。 このパラメーターが有効なポインターの場合、関数は 0 を返します。 詳細については、次の「解説」セクションを参照してください。
戻り値
関数が成功した場合、戻り値はSNMPAPI_SUCCESS。
関数が失敗した場合、戻り値はSNMPAPI_FAILURE。 拡張エラー情報を取得するには、セッション パラメーターに NULL 値を指定して SnmpGetLastError を呼び出します。 SnmpGetLastError 関数は、次のいずれかのエラーを返すことができます。
| リターン コード | 説明 |
|---|---|
|
SnmpStartup 関数が正常に完了しませんでした。 |
|
メモリ割り当て中にエラーが発生しました。 |
|
hEntity パラメーターが無効です。 |
|
nPolicyRetry パラメーターと nActualRetry パラメーターはどちらも NULL です。 操作が実行されませんでした。 |
|
不明または未定義のエラーが発生しました。 |
注釈
通常、エージェント アプリケーションではなく WinSNMP アプリケーションは、 SnmpGetTimeout 関数を呼び出します。
タイムアウト期間は、アプリケーションが SnmpSendMsg 関数を呼び出してから SnmpRecvMsg 関数を呼び出すまでの間隔です。
WinSNMP アプリケーションは、 SnmpSetTimeout 関数を呼び出してタイムアウト値を変更できます。
WinSNMP アプリケーションは 、nActualRetry パラメーターの値を監視し、それを nPolicyRetry パラメーターの値と比較して伝送パフォーマンスを最適化できます。 詳細については、「 再送信 について」および「 再送信ポリシーの管理」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | winsnmp.h |
| Library | Wsnmp32.lib |
| [DLL] | Wsnmp32.dll |