WS_TRANSFER_MODE列舉 (webservices.h)

傳送或接收的訊息是否經過數據流處理或緩衝處理。

Syntax

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 [僅限傳統型應用程式]
標頭	webservices.h