次の方法で共有

WsAbortServiceProxy 関数 (webservices.h)

  • [アーティクル]

サービス プロキシを中止し、 サービス プロキシの保留中の I/O を取り消します。

構文

HRESULT WsAbortServiceProxy(
  [in]           WS_SERVICE_PROXY *serviceProxy,
  [in, optional] WS_ERROR         *error
);

パラメーター

[in] serviceProxy

中止するサービス プロキシを表す WS_SERVICE_PROXY 構造体へのポインター。

[in, optional] error

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

戻り値

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

リターン コード 説明
E_INVALIDARG
 1 つ以上の引数が無効です。

注釈

WsAbortServiceProxy は、 サービス プロキシの状態に応じて次の動作を示します (使用可能な状態については 、WS_SERVICE_PROXY_STATE 列挙を参照してください)。

  • サービス プロキシがを開き、WS_SERVICE_PROXY_STATE_OPENING状態の場合は、 WsAbortServiceProxy を呼び出して開く操作を中止できます。 サービス プロキシは保留中のすべての I/O を取り消し、WS_SERVICE_PROXY_STATE_CREATED状態に戻ります。
  • サービス プロキシが既に開き、WS_SERVICE_PROXY_STATE_OPEN状態の場合、 WsAbortServiceProxy によって、基になるすべてのチャネルがサービス プロキシによって中止され、WS_SERVICE_PROXY_STATE_FAULTED状態に遷移します。 中止が開始されると、サービス プロキシは新しい呼び出しを受け入れなくなります。 アプリケーションは WsCloseServiceProxy を呼び出して閉じることができる
  • サービス プロキシが閉じられ、WS_SERVICE_PROXY_STATE_CLOSING状態の場合は、基になるすべてのチャネルが中止され、サービス プロキシはWS_SERVICE_PROXY_STATE_CLOSED状態に遷移します。

この関数の使用例については、「 ServiceCancellationExample」を参照してください。

要件

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