WsAbortListener 関数 (webservices.h)
指定したリスナーの保留中の I/O を取り消 します。
構文
HRESULT WsAbortListener(
[in] WS_LISTENER *listener,
[in, optional] WS_ERROR *error
);
パラメーター
[in] listener
I/O を取り消すリスナーを表す WS_LISTENER 構造体へのポインター。
[in, optional] error
関数が失敗した場合に追加のエラー情報を受け取る WS_ERROR 構造体へのポインター。
戻り値
関数が成功した場合は、NO_ERRORを返します。それ以外の場合は、HRESULT エラー コードを返します。
注釈
WsAbortListener は、リスナーが任意の状態の場合に呼び出すことができます。 (使用可能な状態については 、WS_LISTENER_STATE 列挙を参照してください)。リスナーがWS_LISTENER_STATE_OPEN状態の場合、この関数はリスナーに強制的にエラーを発生させます (WS_LISTENER_STATE_FAULTED状態にリセットされます)。 リスナーに障害が発生すると、WS_E_OBJECT_FAULTEDエラー コードを使用して、リスナーからのメッセージを受け入れるすべての試行がすぐに失敗します。
この関数は、保留中の I/O が完了するまで待機しません。
有効なパラメーターを指定して呼び出した場合、この関数はシステム リソースの不足などの理由で失敗しません。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 7 [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server 2008 R2 [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | webservices.h |
Library | WebServices.lib |
[DLL] | WebServices.dll |