WSD_APP_SEQUENCE structure (wsdtypes.h)

Article
03/04/2024

Représente les informations de séquence d’application relatives aux messages WS-Discovery.

Syntaxe

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

Membres

InstanceId

Identificateur de l'instance.

SequenceId

Identificateur de séquence.

MessageNumber

Numéro du message.

Remarques

Le bloc d’en-tête de séquencement d’application permet à un récepteur de conserver les messages de séquence qui contiennent ce bloc d’en-tête, bien qu’ils aient été reçus dans le désordre. Cela permet de séquencer correctement les messages Hello et Bye à partir d’un service cible.

Le plan normatif du bloc d’en-tête de séquence d’application est le suivant :

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

Les contraintes normatives de ce plan sont décrites ci-dessous.

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

Ce paramètre doit être incrémenté d’une valeur d’au moins 1 chaque fois que le service s’est arrêté, a perdu l’état et a été restauré. Une application peut définir cette valeur à l’aide d’un compteur incrémenté chaque fois qu’un service est redémarré. Le temps de redémarrage du service est exprimé en secondes écoulées depuis 0 h 00. Le 1er janvier 1970.

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

Ce paramètre identifie une séquence dans le contexte d’un identificateur de instance. Si elle est omise, la valeur implicite est la séquence Null. La valeur de ce paramètre doit être unique dans ./@InstanceId.

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

Ce paramètre identifie un message dans le contexte d’un identificateur de séquence et d’un identificateur de instance. doit être incrémenté d’une valeur d’au moins 1 pour chaque message envoyé. La retransmission de ce message au niveau du transport doit conserver cette valeur.

Configuration requise

Condition requise	Valeur
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	wsdtypes.h (inclure Wsdapi.h)

Voir aussi

Règles de validation appSequence

Partager via