énumération WS_MESSAGE_STATE (webservices.h)

Les différents états dans lequel un message peut se trouver.

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 Valeur : 1 État initial après la création d’un message. Dans cet état, il n’y a pas de contenu dans le message, et ni l’en-tête ni le corps ne sont accessibles.
WS_MESSAGE_STATE_INITIALIZED Valeur : 2 Les en-têtes de message ont été initialisés, et est accessible, mais le corps n’est pas accessible. Cet état est utilisé pour générer tous les en-têtes avant de les écrire ou de les envoyer.
WS_MESSAGE_STATE_READING Valeur : 3 Le corps du message est en cours de lecture, par exemple lorsqu’un message est reçu. Dans cet état, les en-têtes sont accessibles et le corps peut être lu (voir WsReadBody ou WS_MESSAGE_PROPERTY_BODY_READER).
WS_MESSAGE_STATE_WRITING Valeur : 4 Le corps du message est en cours d’écriture, par exemple lorsqu’un message est envoyé. Dans cet état, les en-têtes sont accessibles et le corps peut être écrit (voir WsWriteBody ou WS_MESSAGE_PROPERTY_BODY_WRITER).
WS_MESSAGE_STATE_DONE Valeur : 5 Le corps du message a été lu ou écrit (la fin du body a été lu ou écrit). Les en-têtes sont toujours accessibles.

Remarques

Un objet de message passe par un ensemble d’états à mesure qu’il est reçu ou envoyé (ou lu ou écrit).

Voici les transitions d’état lors de l’écriture ou de l’envoi :

Voici les transitions d’état lors de la lecture ou de la réception :

Notez que dans les diagrammes ci-dessus, seules les transitions valides sont affichées.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
En-tête	webservices.h