Win32 API 日本語リファレンス
ホーム › Networking.WindowsWebServices › WS_SET_CHANNEL_PROPERTY_CALLBACK

WS_SET_CHANNEL_PROPERTY_CALLBACK

コールバック

シグネチャ

HRESULT WS_SET_CHANNEL_PROPERTY_CALLBACK(
    void* channelInstance,
    WS_CHANNEL_PROPERTY_ID id,
    void* value,
    DWORD valueSize,
    WS_ERROR* error
);

パラメーター

フィールド型説明
channelInstancevoid*WS_CREATE_CHANNEL_CALLBACK によって作成された、 このチャネルインスタンス固有の状態へのポインター。
idWS_CHANNEL_PROPERTY_ID設定するプロパティの ID。
valuevoid*設定するプロパティ値へのポインター。 このポインターは、プロパティの型と互換性のあるアラインメントを 持っている必要があります。
valueSizeDWORDプロパティ値のサイズ。
errorWS_ERROR*関数が失敗した場合に、追加のエラー情報を格納する場所を指定します。

公式ドキュメント

WS_CUSTOM_CHANNEL_BINDING に対する WsSetChannelProperty の呼び出しを処理します。

戻り値

戻り値 説明
E_INVALIDARG
 このオブジェクトでは、そのプロパティ ID がサポートされていませんでした。

または、指定されたサイズがそのプロパティに適切ではありませんでした。
E_OUTOFMEMORY
 プロパティ値を設定するための十分な領域がありませんでした。
その他のエラー
この関数は、上記以外のエラーを返す場合があります。

解説(Remarks)

この API のコントラクトについては、WsSetChannelProperty を 参照してください。

どのプロパティのセットをサポートするかは、カスタムチャネルの実装側が 決定します。

プロパティがサポートされていない場合は、E_INVALIDARG を返す必要があります。 (Windows Web Services Return Values を参照してください。)

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)