Share via

WsOpenServiceHost 函数 (webservices.h)

  • 项目

打开 用于通信的服务主机 ，并在所有终结点上启动侦听器。 在调用 WsOpenSerivceHost 之前，客户端应用程序无法连接到服务终结点。

语法

HRESULT WsOpenServiceHost(
  [in]           WS_SERVICE_HOST        *serviceHost,
  [in, optional] const WS_ASYNC_CONTEXT *asyncContext,
  [in, optional] WS_ERROR               *error
);

参数

[in] serviceHost

指向要打开 的服务主机 对象的指针。 指针必须引用由 WsCreateServiceHost 返回的有效 WS_SERVICE_HOST 对象，并且引用的服务主机值不能为 NULL。

[in, optional] asyncContext

指向 WS_ASYNC_CONTEXT 对象的指针，该对象包含有关如何异步调用函数的信息。 如果以同步方式调用，则该值设置为 NULL 。

[in, optional] error

指向 WS_ERROR 对象的指针，如果函数失败，应存储有关错误的其他信息。

返回值

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

返回代码 说明
WS_S_ASYNC
 异步操作仍处于挂起状态。
WS_E_OPERATION_ABORTED
 服务主机在打开前或打开期间中止。
WS_E_INVALID_OPERATION
 服务代理的当前状态对此操作无效。
WS_E_ADDRESS_IN_USE
 地址已被使用。
WS_E_ADDRESS_NOT_AVAILABLE
 地址对此上下文无效。
WS_E_QUOTA_EXCEEDED
 超出配额。
WS_E_OPERATION_ABORTED
 操作已中止。
WS_E_OPERATION_TIMED_OUT
 该操作未在分配的时间内完成。
E_OUTOFMEMORY
 内存不足。
E_INVALIDARG
 一个或多个参数无效。
其他错误
此函数可能会返回上面未列出的其他错误。

注解

请注意，在服务主机接受任何通道以与客户端通信之前，所有终结点侦听器必须成功打开。

要求

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