WS_TRANSFER_MODE列挙 (webservices.h)

送信または受信されたメッセージがストリーミングされるか、バッファーに格納されるか。

構文

typedef enum {
  WS_STREAMED_INPUT_TRANSFER_MODE = 0x1,
  WS_STREAMED_OUTPUT_TRANSFER_MODE = 0x2,
  WS_BUFFERED_TRANSFER_MODE = 0x0,
  WS_STREAMED_TRANSFER_MODE
} WS_TRANSFER_MODE;

定数

WS_STREAMED_INPUT_TRANSFER_MODE 値: 0x1 このフラグを設定すると、メッセージはチャンクで配信されます。 メッセージの先頭 (開始タグ、ヘッダー、および開始本文タグ) がアプリケーションに返されます WsReadMessageStart が完了したとき。 を呼び出すのはアプリケーション次第です メッセージ本文の各チャンクを読み取る前に WsFillBody。 の末尾 WsReadMessageEnd が呼び出されると、メッセージ (終了本文タグと封筒タグ) が読み取られます。 このフラグを設定しない場合は、メッセージ全体が読み取られ、バッファーに格納されていることを意味します WsReadMessageStart が完了を示す前のメモリ内。
WS_STREAMED_OUTPUT_TRANSFER_MODE 値: 0x2 このフラグを設定すると、メッセージはチャンクで送信されます。 メッセージの先頭 (開く) エンベロープ タグ、ヘッダー、および開始本文タグ) は、 WsWriteMessageStart が呼び出されたときに送信されます。 各チャンクを書き込む後に WsFlushBody を呼び出すのはアプリケーションです メッセージ本文の チャンクが送信されます。 残りの本文データは、 WsWriteMessageEnd が呼び出されたときに送信されます。 メッセージの末尾 (本文と封筒のタグを閉じます)。 このフラグを設定しない場合は、メッセージ全体が でバッファーに格納されていることを意味します は、 WsWriteMessageEnd が呼び出された後にのみ送信されます。
WS_BUFFERED_TRANSFER_MODE 値: 0x0 書き込みまたは読み取りが行われるメッセージはバッファーに格納されます。 これは、どちらもを指定するのと同じです WS_STREAMED_INPUT_TRANSFER_MODE も WS_STREAMED_OUTPUT_TRANSFER_MODE。
WS_STREAMED_TRANSFER_MODE 書き込みまたは読み取りが行われるメッセージはストリーミングされます。 これは、両方を指定するのと同じです WS_STREAMED_INPUT_TRANSFER_MODE と WS_STREAMED_OUTPUT_TRANSFER_MODE。

注釈

この値は、 WS_CHANNEL_PROPERTY_TRANSFER_MODE チャネル プロパティを使用してチャネルに指定されます。

ストリーミング プログラミング モデルは、使用される転送モードに関係なく使用できます。 ストリーミングが使用されていない場合、WsFillBody と WsFlushBody の呼び出しの呼び出しは NOP です。

要件

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