WS_CREATE_CHANNEL_FOR_LISTENER_CALLBACK回调函数 (webservices.h)

处理WS_CUSTOM_CHANNEL_BINDINGWsCreateChannelForListener 调用。

语法

WS_CREATE_CHANNEL_FOR_LISTENER_CALLBACK WsCreateChannelForListenerCallback;

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

参数

[in] listenerInstance

指向特定于此侦听器实例的状态的指针,由 WS_CREATE_LISTENER_CALLBACK创建。

channelParameters

指向使用 WsCreateChannelForListener 创建自定义通道时由 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
内存不足。
其他错误
此函数可能会返回上面未列出的其他错误。

注解

有关此 API 协定的信息,请参阅 WsCreateChannelForListener

要求

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