WSDUdpRetransmitParams 结构 (wsdbase.h)

定义用于重复消息传输的参数。

语法

typedef struct _WSDUdpRetransmitParams {
  ULONG ulSendDelay;
  ULONG ulRepeat;
  ULONG ulRepeatMinDelay;
  ULONG ulRepeatMaxDelay;
  ULONG ulRepeatUpperDelay;
} WSDUdpRetransmitParams;

成员

ulSendDelay

发送第一次传输之前等待的时间(以毫秒为单位)。 将零指定为无延迟。 不能为 INFINITE。

ulRepeat

要发送的最大传输数。 指定介于 1 和 256 之间的值(含)。

ulRepeatMinDelay

用于生成初始延迟值的范围的最小值(以毫秒为单位)。 此值必须小于或等于 ulRepeatMaxDelay,可以为零,但不能为 INFINITE。 请参阅“备注”。

ulRepeatMaxDelay

用于生成初始延迟值的范围的最大值(以毫秒为单位)。 此值小于或等于 ulRepeatUpperDelay,可以为零,但不能为 INFINITE。 请参阅“备注”。

ulRepeatUpperDelay

发送消息前等待的最大延迟(以毫秒为单位)。 此值可以为零,但不能为 INFINITE。

注解

如果 ulRepeatMinDelayulRepeatMaxDelayulRepeatUpperDelay 均为零,则消息的重新传输没有延迟。

WSD 在等待 ulSendDelay 后发送第一个传输。 如有必要,WSD 使用其他成员来确定何时重复传输。 WSD 将重复传输到 ulRepeat 时间,并增加传输之间的延迟。 WSD 使用 ulRepeatMinDelayulRepeatMaxDelayulRepeatUpperDelay 成员来确定延迟。

WSD 在 ulRepeatMinDelayulRepeatMaxDelay 的范围内生成一个随机延迟值,并在重复传输之前等待此时间量。 然后,所有后续重复尝试都会将当前延迟值加倍,直到达到 ulRepeatUpperDelay 。 例如,如果初始随机延迟值为 50,上限延迟值为 250,则第二次尝试将等待 50 毫秒,第三次尝试将等待 100 毫秒,第四次尝试将等待 200 毫秒,剩余尝试将等待 250 毫秒。

有关 WSD 如何使用这些值发送消息的详细信息,请参阅 SOAP-over-UDP 规范的附录 I。

要求

   
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
标头 wsdbase.h (包括 Wsdapi.h)

另请参阅

IWSDUdpMessageParameters::GetRetransmitParams

IWSDUdpMessageParameters::SetRetransmitParams