Share via

WsCreateServiceHost 函式 (webservices.h)

  • 發行項

為指定的端點建立 服務主機 。

語法

HRESULT WsCreateServiceHost(
                 const WS_SERVICE_ENDPOINT **endpoints,
  [in]           const USHORT              endpointCount,
                 const WS_SERVICE_PROPERTY *serviceProperties,
  [in]           ULONG                     servicePropertyCount,
                 WS_SERVICE_HOST           **serviceHost,
  [in, optional] WS_ERROR                  *error
);

參數

endpoints

WS_SERVICE_ENDPOINT 結構的陣列，表示要為其建立服務主機的服務端點。

[in] endpointCount

端點陣列中的 端點 數目。

serviceProperties

WS_SERVICE_PROPERTY 結構的陣列，其中包含服務主機的選擇性屬性。

此參數的值可以是 NULL，在此情況下， servicePropertyCount 參數必須是 0 (零) 。

[in] servicePropertyCount

serviceProperties 陣列中的屬性數目。

serviceHost

成功時，會接收代表新服務主機 之WS_SERVICE_HOST 結構的位址的指標。

當您不再需要此結構時，您必須呼叫 WsFreeServiceHost 來釋放它。

[in, optional] error

如果函式失敗，WS_ERROR結構的指標，該結構會收到其他錯誤資訊。

傳回值

如果函式成功，它會傳回NO_ERROR;否則會傳回 HRESULT 錯誤碼。

傳回碼 Description
E_INVALIDARG
 指定了無效的自變數來建立服務主機。
WS_E_QUOTA_EXCEEDED
 超過配額。
E_OUTOFMEMORY
 記憶體不足，無法完成作業。
其他錯誤
此函式可能會傳回上面未列出的其他錯誤。

規格需求

需求 值
最低支援的用戶端 Windows 7 [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 R2 [僅限桌面應用程式]
目標平台 Windows
標頭 webservices.h
程式庫 WebServices.lib
Dll WebServices.dll