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