WSD_APP_SEQUENCE struttura (wsdtypes.h)

Rappresenta le informazioni sulla sequenza di applicazioni relative ai messaggi di WS-Discovery.

Sintassi

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

Members

InstanceId

L'identificatore dell'istanza.

SequenceId

Identificatore di sequenza.

MessageNumber

Numero del messaggio.

Commenti

Il blocco di intestazione di sequenziazione dell'applicazione consente a un ricevitore di mantenere i messaggi della sequenza che contengono questo blocco di intestazione anche se potrebbero essere stati ricevuti in ordine. In questo modo è possibile sequenziare correttamente i messaggi Hello e Bye da un servizio di destinazione.

La struttura normativa per il blocco di intestazione della sequenza di applicazioni è:

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

Di seguito vengono descritti i vincoli normativi di questa struttura.

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

Questa impostazione deve essere incrementata da un valore di almeno 1 ogni volta che il servizio ha terminato, perso stato e ripristinato. Un'applicazione può impostare questo valore usando un contatore incrementato ogni volta che viene riavviato un servizio. L'ora di riavvio del servizio viene espressa come secondi trascorsi dalle 12:00 a.m. 1 gennaio 1970.

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

Questa impostazione identifica una sequenza nel contesto di un identificatore di istanza. Se viene omesso, il valore implicito è la sequenza Null. Il valore in questa impostazione deve essere univoco all'interno di ./@InstanceId.

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

Questa impostazione identifica un messaggio nel contesto di un identificatore di sequenza e un identificatore di istanza. deve essere incrementato da un valore di almeno 1 per ogni messaggio inviato. La ritrasmissione di questo messaggio a livello di trasporto deve mantenere questo valore.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Intestazione	wsdtypes.h (includere Wsdapi.h)

Vedi anche

Regole di convalida appSequence