WsCreateServiceProxy 函式 (webservices.h)

  • 發行項

使用指定的屬性建立 服務 Proxy 。

語法

HRESULT WsCreateServiceProxy(
  [in]           const WS_CHANNEL_TYPE         channelType,
  [in]           const WS_CHANNEL_BINDING      channelBinding,
  [in, optional] const WS_SECURITY_DESCRIPTION *securityDescription,
                 const WS_PROXY_PROPERTY       *properties,
  [in]           const ULONG                   propertyCount,
                 const WS_CHANNEL_PROPERTY     *channelProperties,
  [in]           const ULONG                   channelPropertyCount,
                 WS_SERVICE_PROXY              **serviceProxy,
  [in, optional] WS_ERROR                      *error
);

參數

[in] channelType

WS_CHANNEL_TYPE列舉值，表示服務 Proxy 的通道類型。

[in] channelBinding

表示通道系 結的WS_CHANNEL_BINDING 列舉值。

[in, optional] securityDescription

表示安全性描述 的WS_SECURITY_DESCRIPTION 結構。

properties

WS_PROXY_PROPERTY結構的陣列，其中包含服務 Proxy 的選擇性屬性。

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

[in] propertyCount

屬性陣列中的 屬性 數目。

channelProperties

包含選擇性通道屬性 WS_CHANNEL_PROPERTY 結構的陣列。 此參數的值可以是 Null，在此情況下， channelPropertyCount 參數必須是 0 (零) 。

注意 請非常小心修改這些屬性的預設值。
 

[in] channelPropertyCount

channelProperties陣列中的屬性數目。

serviceProxy

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

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

[in, optional] error

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

傳回值

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

傳回碼 描述
E_INVALIDARG
 一或多個引數無效。
E_OUTOFMEMORY
 記憶體不足，無法完成作業。
其他錯誤
此函式可能會傳回上面未列出的其他錯誤。

規格需求

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