WSD_APP_SEQUENCE-Struktur (wsdtypes.h)

Stellt Anwendungssequenzinformationen im Zusammenhang mit WS-Discovery Nachrichten dar.

Syntax

typedef struct _WSD_APP_SEQUENCE {
  ULONGLONG   InstanceId;
  const WCHAR *SequenceId;
  ULONGLONG   MessageNumber;
} WSD_APP_SEQUENCE;

Member

InstanceId

Der Instanzbezeichner.

SequenceId

Der Sequenzbezeichner

MessageNumber

Die Meldungsnummer.

Hinweise

Der Headerblock für die Anwendungssequenzierung ermöglicht es einem Empfänger, die Sequenznachrichten zu verwalten, die diesen Headerblock enthalten, obwohl sie möglicherweise nicht ordnungsgemäß empfangen wurden. Dies ermöglicht die ordnungsgemäße Sequenzierung von Hello - und Bye-Nachrichten von einem Zieldienst.

Die normative Gliederung für den Headerblock der Anwendungssequenz lautet:

<s:Envelope ...>
  <s:Header ...>
    <d:AppSequence InstanceId='xs:nonNegativeInteger' [SequenceId='xs:anyURI']? MessageNumber='xs:nonNegativeInteger' ... />
  </s:Header>
  <s:Body ...> ...
  </s:Body>
</s:Envelope>

Im Folgenden werden die normativen Einschränkungen dieser Gliederung beschrieben.

/s:Envelope/s:Header/d:AppSequence/@InstanceId

Diese Einstellung muss jedes Mal um einen Wert von mindestens 1 erhöht werden, wenn der Dienst beendet wurde, der Zustand verloren geht und wiederhergestellt wurde. Eine Anwendung kann diesen Wert mithilfe eines Zählers festlegen, der bei jedem Neustart eines Diensts inkrementiert wird. Die Neustartzeit des Diensts wird in Sekunden ausgedrückt, die seit 12:00 Uhr verstrichen sind. 1. Januar 1970.

/s:Envelope/s:Header/d:AppSequence/@SequenceId

Diese Einstellung identifiziert eine Sequenz im Kontext eines instance Bezeichners. Wenn er nicht angegeben wird, ist der implizite Wert die NULL-Sequenz. Der Wert in dieser Einstellung muss innerhalb von ./@InstanceId eindeutig sein.

/s:Envelope/s:Header/d:AppSequence/@MessageNumber

Diese Einstellung identifiziert eine Nachricht im Kontext eines Sequenzbezeichners und eines instance Bezeichners. muss für jede gesendete Nachricht um einen Wert von mindestens 1 erhöht werden. Bei der erneuten Übertragung dieser Nachricht auf Transportebene muss dieser Wert beibehalten werden.

Anforderungen

Weitere Informationen

AppSequence-Validierungsregeln