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 [仅限桌面应用]
标头	webservices.h