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

WS_CREATE_CHANNEL_CALLBACK

コールバック

シグネチャ

HRESULT WS_CREATE_CHANNEL_CALLBACK(
    WS_CHANNEL_TYPE channelType,
    void* channelParameters,
    DWORD channelParametersSize,
    void** channelInstance,
    WS_ERROR* error
);

パラメーター

フィールド型説明
channelTypeWS_CHANNEL_TYPE

チャネルのメッセージ交換パターンです。

カスタムチャネルの実装がそのチャネルの種類をサポートしていない場合は、E_INVALIDARG を返してください。

channelParametersvoid*

カスタムチャネルを WsCreateChannel で作成したときに、 WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_PARAMETERS プロパティで指定された値へのポインターです。

WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_PARAMETERS プロパティが指定されていない場合、値は NULL になります。

channelParametersSizeDWORD

channelParameters が指す値のサイズ (バイト単位) です。

WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_PARAMETERS プロパティが指定されていない場合、サイズは 0 になります。

- **channelInstance

このチャネルインスタンスに固有のデータを格納する、コールバックが割り当てた構造体へのポインターです。このポインターは、 この特定のチャネルインスタンスに対する他のすべてのチャネルコールバックに渡されます。

このコールバックが成功した場合、このパラメーターで返されたチャネルインスタンスの解放には WS_FREE_CHANNEL_CALLBACK が使用されます。

channelInstancevoid**

このチャネルインスタンスに固有のデータを格納する、コールバックが割り当てた構造体へのポインターです。このポインターは、 この特定のチャネルインスタンスに対する他のすべてのチャネルコールバックに渡されます。

このコールバックが成功した場合、このパラメーターで返されたチャネルインスタンスの解放には WS_FREE_CHANNEL_CALLBACK が使用されます。

errorWS_ERROR*関数が失敗した場合に、追加のエラー情報を格納する場所を指定します。

公式ドキュメント

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

戻り値

リターンコード 説明
E_INVALIDARG
 1 つ以上の引数が無効です。
E_OUTOFMEMORY
 メモリが不足しました。
その他のエラー
この関数は、上記以外のエラーを返す場合があります。
出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)