Share via

WsCreateChannelForListener 関数 (webservices.h)

  • [アーティクル]

指定したリスナーに関連付けられた チャネル を作成 します。

構文

HRESULT WsCreateChannelForListener(
  [in]           WS_LISTENER               *listener,
                 const WS_CHANNEL_PROPERTY *properties,
  [in]           ULONG                     propertyCount,
                 WS_CHANNEL                **channel,
  [in, optional] WS_ERROR                  *error
);

パラメーター

[in] listener

チャネルを作成するリスナーを表す WS_LISTENER 構造体へのポインター。 リスナーは任意の状態にすることができます。 (リスナーの状態については、 WS_LISTENER_STATE 列挙を参照してください)。

properties

チャネル初期化の省略可能な値を含む WS_CHANNEL_PROPERTY 構造体の配列。 NULL を指定できます。この場合、propertyCount パラメーターは 0 (ゼロ) である必要があります。

カスタム チャネルの作成については、「解説」セクションを参照してください。

[in] propertyCount

プロパティ配列内の プロパティ の数。

channel

成功した場合、作成されたチャネルのアドレスを受け取るポインター。
チャネルが不要になったら、 WsFreeChannel を呼び出してチャネルを解放する必要があります。

[in, optional] error

関数が失敗した場合に追加のエラー情報を受け取る WS_ERROR 構造体へのポインター。

戻り値

関数が成功した場合は、NO_ERRORを返します。それ以外の場合は、HRESULT エラー コードを返します。

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

注釈

受信メッセージ交換を受け入れるには、 WsAcceptChannel 関数を呼び出します。

チャネルのセキュリティ特性は、リスナーに指定したものと同じです。

( WS_CHANNEL_BINDING 列挙のWS_CUSTOM_CHANNEL_BINDING値を使用して) カスタム チャネルを作成する場合は、次のチャネル プロパティのみを指定できます。

  • WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_CALLBACKS
  • WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_PARAMETERS
カスタム チャネルを作成するために初期プロパティが必要な場合は、WS_CHANNEL_PROPERTY_CUSTOM_CHANNEL_PARAMETERS プロパティを使用して指定します。

要件

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