Share via

WS_CREATE_CHANNEL_FOR_LISTENER_CALLBACKコールバック関数 (webservices.h)

  • [アーティクル]

WS_CUSTOM_CHANNEL_BINDINGの WsCreateChannelForListener 呼び出しを処理 します。

構文

WS_CREATE_CHANNEL_FOR_LISTENER_CALLBACK WsCreateChannelForListenerCallback;

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

パラメーター

[in] listenerInstance

WS_CREATE_LISTENER_CALLBACKによって作成された、このリスナー インスタンスに固有の状態へのポインター。

channelParameters

WsCreateChannelForListener を使用してカスタム チャネルを作成するときに、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

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

戻り値

リターン コード 説明
E_INVALIDARG
 1 つ以上の引数が無効です。
E_OUTOFMEMORY
 メモリが不足しました。
その他のエラー
この関数は、上記以外のエラーを返す場合があります。

注釈

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

要件

要件 値
サポートされている最小のクライアント Windows 7 [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2008 R2 [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー webservices.h