Freigeben über


WSDUdpRetransmitParams-Struktur (wsdbase.h)

Definiert die Parameter zum Wiederholen einer Nachrichtenübertragung.

Syntax

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

Member

ulSendDelay

Die Wartezeit vor dem Senden der ersten Übertragung in Millisekunden. Geben Sie null für keine Verzögerung an. Kann nicht unendlich sein.

ulRepeat

Maximale Anzahl der zu sendenden Übertragungen. Geben Sie einen Wert zwischen 1 und 256 einschließlich an.

ulRepeatMinDelay

Minimaler Wert des Bereichs, der zum Generieren des anfänglichen Verzögerungswerts in Millisekunden verwendet wird. Dieser Wert muss kleiner oder gleich ulRepeatMaxDelay sein, kann null, aber nicht INFINITE sein. Siehe Hinweise.

ulRepeatMaxDelay

Maximaler Wert des Bereichs, der zum Generieren des anfänglichen Verzögerungswerts in Millisekunden verwendet wird. Dieser Wert ist kleiner oder gleich ulRepeatUpperDelay, kann null, aber nicht INFINITE sein. Siehe Hinweise.

ulRepeatUpperDelay

Maximale Verzögerung beim Warten vor dem Senden einer Nachricht in Millisekunden. Dieser Wert kann null, aber nicht UNENDLICH sein.

Hinweise

Wenn ulRepeatMinDelay, ulRepeatMaxDelay und ulRepeatUpperDelay alle null sind, gibt es keine Verzögerung bei der Erneutübertragung der Nachricht.

WSD sendet die erste Übertragung nach warten ulSendDelay. WSD verwendet die anderen Member, um zu bestimmen, wann die Übertragung bei Bedarf wiederholt werden soll. WSD wiederholt die Übertragung bis zu ulRepeat-Zeiten mit zunehmenden Verzögerungen zwischen der Übertragung. WSD verwendet die Member ulRepeatMinDelay, ulRepeatMaxDelay und ulRepeatUpperDelay , um die Verzögerung zu bestimmen.

WSD generiert einen zufälligen Verzögerungswert im Bereich ulRepeatMinDelay bis ulRepeatMaxDelay und wartet diesen Zeitraum, bevor die Übertragung wiederholt wird. Alle nachfolgenden Wiederholungsversuche verdoppeln dann den aktuellen Verzögerungswert, bis ulRepeatUpperDelay erreicht ist. Wenn beispielsweise der anfängliche zufällige Verzögerungswert 50 und der obere Verzögerungswert 250 ist, wartet der zweite Versuch 50 Millisekunden, der dritte Versuch wartet 100 Millisekunden, der vierte Versuch wartet 200 Millisekunden, und die verbleibenden Versuche warten 250 Millisekunden.

Ausführliche Informationen dazu, wie WSD diese Werte zum Senden von Nachrichten verwendet, finden Sie in Anhang I der SOAP-over-UDP-Spezifikation .

Anforderungen

   
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Kopfzeile wsdbase.h (include Wsdapi.h)

Weitere Informationen

IWSDUdpMessageParameters::GetRetransmitParams

IWSDUdpMessageParameters::SetRetransmitParams