WS_MESSAGE_STATE列挙 (webservices.h)

  • [アーティクル]

メッセージが含まれる可能性があるさまざまな状態。

構文

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;

定数

 
WS_MESSAGE_STATE_EMPTY
値: 1
メッセージが作成された後の初期状態。
この状態では、メッセージにコンテンツはありません。
ヘッダーも本文にもアクセスできません。
WS_MESSAGE_STATE_INITIALIZED
値: 2
メッセージ ヘッダーが初期化されました。
にアクセスできますが、本文にアクセスすることはできません。 この状態
は、書き込み/送信前にすべてのヘッダーを構築するために使用されます。
WS_MESSAGE_STATE_READING
値: 3
たとえば、メッセージの本文が読み取られている
メッセージが受信されたとき。
この状態では、ヘッダーにアクセスでき、本文は
読み取る ( WsReadBody または を参照)
WS_MESSAGE_PROPERTY_BODY_READER)。
WS_MESSAGE_STATE_WRITING
値: 4
たとえば、メッセージの本文が書き込まれます
メッセージが送信されるとき。
この状態では、ヘッダーにアクセスでき、本文は
書き込み可能です ( WsWriteBody または
WS_MESSAGE_PROPERTY_BODY_WRITER)。
WS_MESSAGE_STATE_DONE
値: 5
メッセージ本文が読み取りまたは書き込まれた (の末尾)
本文が読み取られたか書き込まれています)。 ヘッダーには引き続きアクセスできます。

注釈

メッセージ オブジェクトは、受信または送信中 (または読み取りまたは書き込み) 中に、一連の状態を遷移します。

書き込み中または送信中の状態遷移を次に示します。

Message オブジェクトの書き込み中または送信中の有効な状態遷移の図。

読み取りまたは受信中の状態遷移を次に示します。

Message オブジェクトの読み取り中または受信中の有効な状態遷移の図。

上の図では、有効な遷移のみが表示されることに注意してください。

要件

要件 値
サポートされている最小のクライアント Windows 7 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 R2 [デスクトップ アプリのみ]
Header webservices.h