Windows Dev Center

Expand Minimize

WSDUdpRetransmitParams structure

Defines the parameters for repeating a message transimission.

Syntax


typedef struct _WSDUpdRetransmitParams {
  ULONG ulSendDelay;
  ULONG ulRepeat;
  ULONG ulRepeatMinDelay;
  ULONG ulRepeatMaxDelay;
  ULONG ulRepeatUpperDelay;
} WSDUdpRetransmitParams, *PWSDUdpRetransmitParams;

Members

ulSendDelay

Time to wait before sending the first transmission, in milliseconds. Specify zero for no delay. Cannot be INFINITE.

ulRepeat

Maximum number of transmissions to send. Specify a value between 1 and 256, inclusively.

ulRepeatMinDelay

Minimum value of the range used to generate the initial delay value, in milliseconds. This value must be less than or equal to ulRepeatMaxDelay, can be zero, but cannot be INFINITE. See Remarks.

ulRepeatMaxDelay

Maximum value of the range used to generate the initial delay value, in milliseconds. This value be less than or equal to ulRepeatUpperDelay, can be zero, but cannot be INFINITE. See Remarks.

ulRepeatUpperDelay

Maximum delay to wait before sending message, in milliseconds. This value be can be zero, but cannot be INFINITE.

Remarks

If ulRepeatMinDelay, ulRepeatMaxDelay, and ulRepeatUpperDelay are all zero, there is no delay in retransmission of the message.

WSD sends the first transmission after waiting ulSendDelay. WSD uses the other members to determine when to repeat the transmission, if necessary. WSD repeats the transmission up to ulRepeat times with increasing delays between transmission. WSD uses the ulRepeatMinDelay, ulRepeatMaxDelay, and ulRepeatUpperDelay members to determine the delay.

WSD generates a random delay value in the range ulRepeatMinDelay to ulRepeatMaxDelay and waits this amount of time before repeating the transmission. All subsequent repeat attempts then double the current delay value until ulRepeatUpperDelay is reached. For example, if the initial random delay value is 50 and the upper delay value is 250, the second attempt will wait 50 milliseconds, the third attempt will wait 100 milliseconds, the fourth attempt will wait 200 milliseconds, and the remaining attempts will wait 250 milliseconds.

For details on how WSD uses these values to send messages, see Appendix I of the SOAP-over-UDP specification.

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

Wsdbase.h (include Wsdapi.h)

IDL

Wsdbase.idl

See also

IWSDUdpMessageParameters::GetRetransmitParams
IWSDUdpMessageParameters::SetRetransmitParams

 

 

Community Additions

ADD
Show:
© 2015 Microsoft