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 |