WsAbortChannel 関数 (webservices.h)

  • [アーティクル]

指定されたチャネルの保留中のすべての I/O を取り消します

構文

HRESULT WsAbortChannel(
  [in]           WS_CHANNEL *channel,
  [in, optional] WS_ERROR   *error
);

パラメーター

[in] channel

I/O を取り消すチャネルを表す WS_CHANNEL 構造体へのポインター。

[in, optional] error

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

戻り値

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

リターン コード 説明
WS_E_NOT_SUPPORTED
 プラットフォームの制限については、「解説」セクションを参照してください。
E_INVALIDARG
 1 つ以上の引数が無効です。

解説

Windows Server 2003 以前: Windows Vista より前の Windows プラットフォームでは、チャネルがWS_CHANNEL_STATE_ACCEPTING状態でリスナーがまだ中止されていない場合、この関数はWS_UDP_CHANNEL_BINDINGまたはWS_HTTP_CHANNEL_BINDINGではサポートされません。

(チャネル バインドとチャネルの状態については、 WS_CHANNEL_BINDING および WS_CHANNEL_STATE 列挙を参照してください)。

この関数は、WS_CHANNEL_STATE_OPENまたはWS_CHANNEL_STATE_FAULTED状態でチャネルを中止するときに、WS_CHANNEL_TYPE_REPLYを使用したWS_HTTP_CHANNEL_BINDINGでもサポートされていません。 (チャネルの種類の詳細については、 WS_CHANNEL_TYPE 列挙を参照してください。

WsAbortChannel は 、任意の状態のチャネルに対して呼び出すことができます。チャネルを中止する前に、保留中の I/O が完了するまで待機しません。

チャネルが WS_CHANNEL_STATE_OPEN 状態の場合、 WsAbortChannel によってチャネルが WS_CHANNEL_STATE_FAULTED 状態に障害が発生します。

メモ 特定のメッセージをスキップし、チャネルを開いたままにする方法については、「 WsAbandonMessage 」を参照してください。

 
有効なパラメーターを指定して呼び出した場合、この関数はシステム リソースの不足などの理由で失敗しません。 ただし、「備考」の冒頭にあるオペレーティング システムの一部のバージョンに関する制限事項に注意してください。

要件

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