共用方式為


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