通过

WsCreateListener 函数 (webservices.h)

  • 项目

创建具有指定属性的 侦听器 。

语法

HRESULT WsCreateListener(
  [in]           WS_CHANNEL_TYPE               channelType,
  [in]           WS_CHANNEL_BINDING            channelBinding,
                 const WS_LISTENER_PROPERTY    *properties,
  [in]           ULONG                         propertyCount,
  [in, optional] const WS_SECURITY_DESCRIPTION *securityDescription,
                 WS_LISTENER                   **listener,
  [in, optional] WS_ERROR                      *error
);

参数

[in] channelType

侦听器侦听的通道类型。 有关通道类型，请参阅 WS_CHANNEL_TYPE 枚举。

[in] channelBinding

侦听器的通道协议。 有关可能的绑定，请参阅 WS_CHANNEL_BINDING 枚举。

properties

指向包含侦听器可选属性 的WS_LISTENER_PROPERTY 结构的指针。

有关在创建侦听器时可以指定哪些属性的信息，请参阅 WS_LISTENER_PROPERTY_ID 枚举。

有关创建自定义侦听器的信息，请参阅“备注”部分。

[in] propertyCount

properties 数组中的 属性 数。

[in, optional] securityDescription

指向指定侦听器安全性 的WS_SECURITY_DESCRIPTION 结构的指针。

如果使用 WS_CHANNEL_BINDING 枚举) 的WS_CUSTOM_CHANNEL_BINDING值创建自定义通道 (，则安全说明必须为 NULL。 请参阅“备注”部分。

listener

成功时，一个指针，用于接收表示新侦听器的 WS_LISTENER 结构的地址。

[in, optional] error

指向 WS_ERROR 结构的指针，该结构在函数失败时接收其他错误信息。

返回值

如果函数成功，则返回NO_ERROR;否则，它将返回 HRESULT 错误代码。

返回代码 说明
WS_E_QUOTA_EXCEEDED
 超出配额。
E_OUTOFMEMORY
 内存不足，无法完成操作。
E_INVALIDARG
 一个或多个参数无效。
其他错误
此函数可能会返回上面未列出的其他错误。

注解

使用 WS_CHANNEL_BINDING 枚举) 的WS_CUSTOM_CHANNEL_BINDING值创建自定义侦听器 (时，只能指定以下通道属性：

  • WS_LISTENER_PROPERTY_CUSTOM_LISTENER_CALLBACKS
  • WS_LISTENER_PROPERTY_CUSTOM_LISTENER_PARAMETERS
(请参阅 WS_LISTENER_PROPERTY_ID enumeration.) 如果需要其他初始属性来创建自定义侦听器，请使用 WS_LISTENER_PROPERTY_CUSTOM_LISTENER_PARAMETERS 属性指定这些属性。

若要将安全信息传递给自定义侦听器实现，请使用 WS_LISTENER_PROPERTY_ID 枚举的 WS_LISTENER_PROPERTY_CUSTOM_LISTENER_PARAMETERS 值。

要求

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