WSDUdpRetransmitParams 構造体 (wsdbase.h)
メッセージ転送を繰り返すパラメーターを定義します。
構文
typedef struct _WSDUdpRetransmitParams {
ULONG ulSendDelay;
ULONG ulRepeat;
ULONG ulRepeatMinDelay;
ULONG ulRepeatMaxDelay;
ULONG ulRepeatUpperDelay;
} WSDUdpRetransmitParams;
メンバー
ulSendDelay
最初の送信を送信するまでの待機時間 (ミリ秒単位)。 遅延がない場合は 0 を指定します。 INFINITE にすることはできません。
ulRepeat
送信する送信の最大数。 1 ~ 256 の値を指定します (両端を含む)。
ulRepeatMinDelay
初期遅延値の生成に使用される範囲の最小値 (ミリ秒単位)。 この値は ulRepeatMaxDelay 以下である必要があり、0 にすることはできますが、INFINITE にすることはできません。 「解説」を参照してください。
ulRepeatMaxDelay
初期遅延値の生成に使用される範囲の最大値 (ミリ秒単位)。 この値は ulRepeatUpperDelay 以下で、0 にすることはできますが、INFINITE にすることはできません。 「解説」を参照してください。
ulRepeatUpperDelay
メッセージの送信前に待機する最大遅延時間 (ミリ秒単位)。 この値は 0 にできますが、INFINITE にすることはできません。
解説
ulRepeatMinDelay、ulRepeatMaxDelay、ulRepeatUpperDelay がすべて 0 の場合、メッセージの再送信に遅延はありません。
WSD は 、ulSendDelay を待機した後に最初の転送を送信します。 WSD は、必要に応じて、他のメンバーを使用して転送を繰り返すタイミングを決定します。 WSD は、送信間の遅延を増やして 、送信を ulRepeat 時間まで繰り返します。 WSD では、 ulRepeatMinDelay、 ulRepeatMaxDelay、 および ulRepeatUpperDelay メンバーを使用して遅延を判断します。
WSD は 、ulRepeatMinDelay から ulRepeatMaxDelay までの範囲でランダムな遅延値を生成し、送信を繰り返す前にこの時間を待機します。 後続のすべての繰り返し試行は、 ulRepeatUpperDelay に達するまで現在の遅延値を 2 倍にします。 たとえば、最初のランダム遅延値が 50 で、上限の遅延値が 250 の場合、2 回目の試行は 50 ミリ秒待機し、3 回目の試行は 100 ミリ秒待機し、4 回目の試行は 200 ミリ秒待機し、残りの試行は 250 ミリ秒待機します。
WSD でこれらの値を使用してメッセージを送信する方法の詳細については、 SOAP over-UDP 仕様の付録 I を参照してください。
要件
| サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
| Header | wsdbase.h (Wsdapi.h を含む) |