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 |
---|---|
|
這個物件不支援屬性標識碼,或指定的緩衝區不足以用於值。 |
|
記憶體不足。 |
|
此函式可能會傳回上述未列出的其他錯誤。 |
備註
如需此 API 合約的相關信息,請參閱 WsGetChannelProperty 。
每個自訂通道實作都必須支援至少傳回下列屬性的值:
- WS_CHANNEL_PROPERTY_ADDRESSING_VERSION
- WS_CHANNEL_PROPERTY_ENVELOPE_VERSION
- WS_CHANNEL_PROPERTY_TRANSFER_MODE
- WS_CHANNEL_PROPERTY_PROTECTION_LEVEL
自定義通道實作是決定它想要支援的任何其他屬性。
如果不支援屬性,則應該傳回 E_INVALIDARG 。 (請參閱 Windows Web 服務傳回值。)
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 7 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2008 R2 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | webservices.h |