Compartilhar via


enumeração WS_MESSAGE_STATE (webservices.h)

Os diferentes estados em que uma mensagem pode estar.

Syntax

typedef enum {
  WS_MESSAGE_STATE_EMPTY = 1,
  WS_MESSAGE_STATE_INITIALIZED = 2,
  WS_MESSAGE_STATE_READING = 3,
  WS_MESSAGE_STATE_WRITING = 4,
  WS_MESSAGE_STATE_DONE = 5
} WS_MESSAGE_STATE;

Constantes

 
WS_MESSAGE_STATE_EMPTY
Valor: 1
O estado inicial após a criação de uma mensagem.
Nesse estado, não há conteúdo na mensagem e
nem o cabeçalho nem o corpo podem ser acessados.
WS_MESSAGE_STATE_INITIALIZED
Valor: 2
Os cabeçalhos de mensagem foram inicializados e
pode ser acessado, mas o corpo não pode ser acessado. Esse estado
é usado para compilar todos os cabeçalhos antes de escrevê-los/enviá-los.
WS_MESSAGE_STATE_READING
Valor: 3
O corpo da mensagem está sendo lido, por exemplo
quando uma mensagem é recebida.
Nesse estado, os cabeçalhos podem ser acessados e o corpo pode
ser lido (consulte WsReadBody ou
WS_MESSAGE_PROPERTY_BODY_READER).
WS_MESSAGE_STATE_WRITING
Valor: 4
O corpo da mensagem está sendo gravado, por exemplo
quando uma mensagem está sendo enviada.
Nesse estado, os cabeçalhos podem ser acessados e o corpo pode
ser gravado (consulte WsWriteBody ou
WS_MESSAGE_PROPERTY_BODY_WRITER).
WS_MESSAGE_STATE_DONE
Valor: 5
O corpo da mensagem foi lido ou gravado (o final do
o corpo foi lido ou gravado). Os cabeçalhos ainda podem ser acessados.

Comentários

Um objeto de mensagem faz a transição por meio de um conjunto de estados à medida que está sendo recebido ou enviado (ou lido ou gravado).

Veja a seguir as transições de estado durante a gravação ou envio:

Diagrama das transições de estado válidas para um objeto Message enquanto ele está sendo gravado ou enviado.

Veja a seguir as transições de estado durante a leitura ou recebimento:

Diagrama das transições de estado válidas para um objeto Message enquanto ele está sendo lido ou recebido.

Observe que, nos diagramas acima, somente transições válidas são mostradas.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Cabeçalho webservices.h