Compartilhar via

estrutura WSD_APP_SEQUENCE (wsdtypes.h)

  • Artigo

Representa informações de sequência de aplicativos relacionadas a mensagens de WS-Discovery.

Sintaxe

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

Membros

InstanceId

O identificador da instância.

SequenceId

O identificador de sequência.

MessageNumber

O número da mensagem.

Comentários

O bloco de cabeçalho de sequenciamento de aplicativo permite que um receptor mantenha as mensagens de sequência que contêm esse bloco de cabeçalho, embora possam ter sido recebidas fora de ordem. Isso permite o sequenciamento adequado de mensagens Hello e Bye de um serviço de destino.

A estrutura de tópicos normativa para o bloco de cabeçalho da sequência de aplicativos é:

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

O seguinte descreve as restrições normativas dessa estrutura de tópicos.

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

Essa configuração deve ser incrementada por um valor de pelo menos 1 cada vez que o serviço for encerrado, estado perdido e restaurado. Um aplicativo pode definir esse valor usando um contador incrementado sempre que um serviço é reiniciado. O tempo de reinicialização do serviço é expresso como segundos decorridos desde as 00:00. 1º de janeiro de 1970.

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

Essa configuração identifica uma sequência dentro do contexto de um identificador de instância. Se for omitido, o valor implícito será a sequência nula. O valor nessa configuração deve ser exclusivo em ./@InstanceId.

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

Essa configuração identifica uma mensagem dentro do contexto de um identificador de sequência e de um identificador de instância. deve ser incrementado por um valor de pelo menos 1 para cada mensagem enviada. A retransmissão dessa mensagem no nível do transporte deve manter esse valor.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 [somente aplicativos da área de trabalho]
Cabeçalho wsdtypes.h (inclua Wsdapi.h)

Confira também

Regras de validação do AppSequence