WsCreateListener 関数 (webservices.h)

  • [アーティクル]

指定したプロパティを持つリスナーを作成 します 。

構文

HRESULT WsCreateListener(
  [in]           WS_CHANNEL_TYPE               channelType,
  [in]           WS_CHANNEL_BINDING            channelBinding,
                 const WS_LISTENER_PROPERTY    *properties,
  [in]           ULONG                         propertyCount,
  [in, optional] const WS_SECURITY_DESCRIPTION *securityDescription,
                 WS_LISTENER                   **listener,
  [in, optional] WS_ERROR                      *error
);

パラメーター

[in] channelType

リスナーがリッスンするチャネルの種類。 チャネルの種類については、 WS_CHANNEL_TYPE 列挙を参照してください。

[in] channelBinding

リスナーのチャネル プロトコル。 可能なバインディングについては、 WS_CHANNEL_BINDING 列挙を参照してください。

properties

リスナーの省略可能なプロパティを含む WS_LISTENER_PROPERTY 構造体へのポインター。

リスナーの作成時に指定できるプロパティについては、 WS_LISTENER_PROPERTY_ID 列挙を参照してください。

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

[in] propertyCount

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

[in, optional] securityDescription

リスナーのセキュリティを指定する WS_SECURITY_DESCRIPTION 構造体へのポインター。

( WS_CHANNEL_BINDING 列挙のWS_CUSTOM_CHANNEL_BINDING値を使用して) カスタム チャネルを作成する場合、セキュリティの説明は NULL である必要があります。 「解説」を参照してください。

listener

成功した場合、新しいリスナーを表す WS_LISTENER 構造体のアドレスを受け取るポインター。

[in, optional] error

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

戻り値

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

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

解説

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

  • WS_LISTENER_PROPERTY_CUSTOM_LISTENER_CALLBACKS
  • WS_LISTENER_PROPERTY_CUSTOM_LISTENER_PARAMETERS
( WS_LISTENER_PROPERTY_ID 列挙を参照してください)。カスタム リスナーを作成するために他の初期プロパティが必要な場合は、WS_LISTENER_PROPERTY_CUSTOM_LISTENER_PARAMETERS プロパティを使用して指定します。

カスタム リスナー実装にセキュリティ情報を渡すには、WS_LISTENER_PROPERTY_ID列挙の WS_LISTENER_PROPERTY_CUSTOM_LISTENER_PARAMETERS 値を使用します。

要件

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