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

屬性陣列中的 屬性 數目。

[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
程式庫 WebServices.lib
Dll WebServices.dll