WS_CREATE_ENCODER_CALLBACK回调函数 (webservices.h)

处理创建编码器实例。

语法

WS_CREATE_ENCODER_CALLBACK WsCreateEncoderCallback;

HRESULT WsCreateEncoderCallback(
  [in]           void *createContext,
  [in]           WS_WRITE_CALLBACK writeCallback,
  [in]           void *writeContext,
                 void **encoderContext,
  [in, optional] WS_ERROR *error
)
{...}

参数

[in] createContext

在通道创建期间使用的 WS_CHANNEL_ENCODER 中指定的 createContext。

[in] writeCallback

应用于写入消息数据的函数。 此回调只能用于响应 WS_ENCODER_START_CALLBACKWS_ENCODER_ENCODE_CALLBACKWS_ENCODER_END_CALLBACK 回调。

[in] writeContext

应传递给提供的 WS_WRITE_CALLBACK的写入上下文。

encoderContext

返回编码器实例。 此值将传递给所有编码器回调。

[in, optional] error

指定在函数失败时应存储其他错误信息的位置。

返回值

此回调函数可以返回其中一个值。

返回代码 说明
E_OUTOFMEMORY
内存不足。
E_INVALIDARG
一个或多个参数无效。
其他错误
此函数可能会返回上面未列出的其他错误。

注解

通道将根据需要创建编码器实例。 每个编码器实例将以单线程方式调用。 但是,单个编码器实例不应假定它将看到来自一个通道的所有消息,因为该通道可能会使用多个编码器实例来处理消息。

要求

要求
最低受支持的客户端 Windows 7 [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 R2 [仅限桌面应用]
目标平台 Windows
标头 webservices.h