WsCloseListener 関数 (webservices.h)

  • [アーティクル]

指定した リスナー がリッスンを停止します。

構文

HRESULT WsCloseListener(
  [in]           WS_LISTENER            *listener,
  [in, optional] const WS_ASYNC_CONTEXT *asyncContext,
  [in, optional] WS_ERROR               *error
);

パラメーター

[in] listener

閉じるリスナーを表す WS_LISTENER 構造体へのポインター。

[in, optional] asyncContext

関数を非同期的に呼び出すための情報を含む WS_ASYNC_CONTEXT 構造体へのポインター。 NULL を渡して関数を同期的に呼び出します。

[in, optional] error

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

戻り値

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

リターン コード 説明
WS_S_ASYNC
 非同期操作はまだ保留中です。
WS_E_OPERATION_ABORTED
 リスナーが閉じているとき、 WsAbortListener の呼び出しによってクローズが中止されました。
WS_E_INVALID_OPERATION
 リスナーが不適切な状態でした。
WS_E_OPERATION_TIMED_OUT
 割り当てられた時間内に操作が完了しませんでした。
E_INVALIDARG
 1 つ以上の引数が無効です。
その他のエラー
この関数は、上記以外のエラーを返す場合があります。

注釈

リスナーを閉じた後、リスナーを安全に解放できます。

この操作は、 WS_LISTENER_STATE_OPENまたはWS_LISTENER_STATE_FAULTED 状態のリスナーに対 して 許可されます。 (リスナーの状態については、 WS_LISTENER_STATE 列挙を参照してください)。

リスナーを閉じると、 WsAcceptChannel メソッドを使用してチャネルを受け入れる保留中の試行はすべて中止されます。 ただし、 WsCloseListener は、保留中の I/O が完了するまで待機してから、終了プロセスに進みます。

要件

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