Partager via


Structure WSDUdpRetransmitParams (wsdbase.h)

Définit les paramètres de répétition d’une transmission de message.

Syntaxe

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

Membres

ulSendDelay

Délai d’attente avant d’envoyer la première transmission, en millisecondes. Spécifiez zéro pour aucun délai. Ne peut pas être INFINI.

ulRepeat

Nombre maximal de transmissions à envoyer. Spécifiez une valeur comprise entre 1 et 256, inclusivement.

ulRepeatMinDelay

Valeur minimale de la plage utilisée pour générer la valeur de délai initiale, en millisecondes. Cette valeur doit être inférieure ou égale à ulRepeatMaxDelay, peut être égale à zéro, mais ne peut pas être INFINITE. Consultez la section Notes.

ulRepeatMaxDelay

Valeur maximale de la plage utilisée pour générer la valeur de délai initiale, en millisecondes. Cette valeur est inférieure ou égale à ulRepeatUpperDelay, peut être égale à zéro, mais ne peut pas être INFINITE. Consultez la section Notes.

ulRepeatUpperDelay

Délai maximal d’attente avant l’envoi du message, en millisecondes. Cette valeur peut être égale à zéro, mais ne peut pas être INFINIE.

Remarques

Si ulRepeatMinDelay, ulRepeatMaxDelay et ulRepeatUpperDelay sont tous zéro, la retransmission du message n’est pas retardée.

WSD envoie la première transmission après avoir attendu ulSendDelay. WSD utilise les autres membres pour déterminer quand répéter la transmission, si nécessaire. WSD répète la transmission jusqu’à des heures ulRepeat avec des retards croissants entre la transmission. WSD utilise les membres ulRepeatMinDelay, ulRepeatMaxDelay et ulRepeatUpperDelay pour déterminer le délai.

WSD génère une valeur de délai aléatoire dans la plage ulRepeatMinDelay à ulRepeatMaxDelay et attend ce laps de temps avant de répéter la transmission. Toutes les tentatives répétées suivantes doublent ensuite la valeur du délai actuel jusqu’à ce que ulRepeatUpperDelay soit atteint. Par exemple, si la valeur de délai aléatoire initiale est 50 et la valeur de délai supérieure est 250, la deuxième tentative attend 50 millisecondes, la troisième tentative attend 100 millisecondes, la quatrième tentative attend 200 millisecondes et les autres tentatives attendent 250 millisecondes.

Pour plus d’informations sur la façon dont WSD utilise ces valeurs pour envoyer des messages, consultez l’Annexe I de la spécification SOAP-over-UDP .

Spécifications

   
Client minimal pris en charge Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau uniquement]
En-tête wsdbase.h (inclure Wsdapi.h)

Voir aussi

IWSDUdpMessageParameters::GetRetransmitParams

IWSDUdpMessageParameters::SetRetransmitParams