WS_GET_CHANNEL_PROPERTY_CALLBACK回呼函式 (webservices.h)

處理WS_CUSTOM_CHANNEL_BINDING的 WsGetChannelProperty 呼叫。

語法

WS_GET_CHANNEL_PROPERTY_CALLBACK WsGetChannelPropertyCallback;

HRESULT WsGetChannelPropertyCallback(
  [in]           void *channelInstance,
  [in]           WS_CHANNEL_PROPERTY_ID id,
                 void *value,
  [in]           ULONG valueSize,
  [in, optional] WS_ERROR *error
)
{...}

參數

[in] channelInstance

這個通道實例所建立之狀態的指標，如 WS_CREATE_CHANNEL_CALLBACK所建立。

[in] id

要擷取之屬性的標識碼。

value

要儲存所擷取屬性的位置。 指標必須具有與 屬性類型相容的對齊方式。

[in] valueSize

呼叫端所配置的位元組數目，以儲存所擷取的屬性。

[in, optional] error

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

傳回值

傳回碼	Description
E_INVALIDARG	這個物件不支援屬性標識碼，或指定的緩衝區不足以用於值。
E_OUTOFMEMORY	記憶體不足。
其他錯誤	此函式可能會傳回上述未列出的其他錯誤。

備註

如需此 API 合約的相關信息，請參閱 WsGetChannelProperty 。

每個自訂通道實作都必須支援至少傳回下列屬性的值：

• WS_CHANNEL_PROPERTY_ADDRESSING_VERSION
• WS_CHANNEL_PROPERTY_ENVELOPE_VERSION
• WS_CHANNEL_PROPERTY_TRANSFER_MODE
• WS_CHANNEL_PROPERTY_PROTECTION_LEVEL

服務模型層提供自己的呼叫逾時邏輯，因此需要停用基礎通道中的逾時。 為了讓自定義通道從服務模型層使用，它應該支援停用其所有逾時，並針對 WS_CHANNEL_PROPERTY_ENABLE_TIMEOUTS實作此回呼。 除非查詢 WS_CHANNEL_PROPERTY_ENABLE_TIMEOUTS 傳回 FALSE，否則無法透過服務模型使用自定義通道。

自定義通道實作是決定它想要支援的任何其他屬性。

如果不支援屬性，則應該傳回 E_INVALIDARG 。 (請參閱 Windows Web 服務傳回值。)

規格需求

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