WsCreateChannelForListener 函式 (webservices.h)

  • 發行項

建立與指定接聽程式相關聯的通道。

語法

HRESULT WsCreateChannelForListener(
  [in]           WS_LISTENER               *listener,
                 const WS_CHANNEL_PROPERTY *properties,
  [in]           ULONG                     propertyCount,
                 WS_CHANNEL                **channel,
  [in, optional] WS_ERROR                  *error
);

參數

[in] listener

WS_LISTENER 結構的指標，表示要為其建立通道的接聽程式。 接聽程式可以處於任何狀態。 (如需接聽程序狀態，請參閱 WS_LISTENER_STATE enumeration.)

properties

WS_CHANNEL_PROPERTY 結構的陣列，其中包含通道初始化的選擇性值。 這可以是 NULL，在此情況下， propertyCount 參數必須是 0 (零) 。

如需建立自定義通道的資訊，請參閱一節。

[in] propertyCount

屬性陣列中的 屬性 數目。

channel

成功時，會接收所建立通道位址的指標。
當不再需要通道時，您必須呼叫 WsFreeChannel 來釋出通道。

[in, optional] error

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

傳回值

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

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

備註

若要接受傳入訊息交換，請呼叫 WsAcceptChannel 函式。

通道的安全性特性與為接聽程式指定的安全性特性相同。

當您使用 WS_CHANNEL_BINDING 列舉) 的WS_CUSTOM_CHANNEL_BINDING值建立自定義通道 (時，您只能指定下列通道屬性：

  • WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_CALLBACKS
  • WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_PARAMETERS
如果需要初始屬性才能建立自定義通道，請使用 WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_PARAMETERS 屬性加以指定。

規格需求

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