WS_CREATE_CHANNEL_CALLBACK webservices.h (回呼函式)

  • 發行項

處理WS_CUSTOM_CHANNEL_BINDING的 WsCreateChannel 呼叫。

語法

WS_CREATE_CHANNEL_CALLBACK WsCreateChannelCallback;

HRESULT WsCreateChannelCallback(
  [in]           WS_CHANNEL_TYPE channelType,
                 const void *channelParameters,
  [in]           ULONG channelParametersSize,
                 void **channelInstance,
  [in, optional] WS_ERROR *error
)
{...}

參數

[in] channelType

通道的訊息交換模式。

如果自定義通道實作不支援通道的類型，應該傳回 E_INVALIDARG 。

channelParameters

使用 WsCreateChannel 建立自定義通道時，WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_PARAMETERS 屬性所指定的值指標。

如果未指定 WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_PARAMETERS 屬性，此值會是 NULL。

[in] channelParametersSize

channelParameters 所指向之值的位元元組大小。

如果未指定 WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_PARAMETERS 屬性，大小將會是 0。

channelInstance

回呼所配置之結構的指標，其中包含這個通道實例專屬的數據。 此指標會傳遞至這個特定通道實例的所有其他通道回呼。

如果此回呼成功，則 WS_FREE_CHANNEL_CALLBACK 將用來釋放此參數中傳回的通道實例。

[in, optional] error

指定函式失敗時應儲存其他錯誤資訊的位置。

傳回值

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

規格需求

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