WS_CREATE_CHANNEL_CALLBACK回调函数 (webservices.h)

处理WS_CUSTOM_CHANNEL_BINDINGWsCreateChannel 调用。

语法

WS_CREATE_CHANNEL_CALLBACK WsCreateChannelCallback;

HRESULT WsCreateChannelCallback(
  [in]           WS_CHANNEL_TYPE channelType,
                 const void *channelParameters,
  [in]           ULONG channelParametersSize,
                 void **channelInstance,
  [in, optional] WS_ERROR *error
)
{...}

参数

[in] channelType

通道的消息交换模式。

如果自定义通道实现不支持通道类型,应返回 E_INVALIDARG

channelParameters

指向使用 WsCreateChannel 创建自定义通道时由 WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_PARAMETERS 属性指定的值的指针。

如果未指定 WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_PARAMETERS 属性,则该值将为 NULL

[in] channelParametersSize

channelParameters 指向的值的大小(以字节为单位)。

如果未指定 WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_PARAMETERS 属性,则大小将为 0。

channelInstance

指向由回调分配的结构的指针,该结构包含特定于此通道实例的数据。 此指针将传递给此特定通道实例的所有其他通道回调。

如果此回调成功,则 WS_FREE_CHANNEL_CALLBACK 将用于释放此参数中返回的通道实例。

[in, optional] error

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

返回值

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

要求

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