WsCloseServiceProxy 関数 (webservices.h)

  • [アーティクル]

指定した サービス プロキシとの通信を閉じます。

構文

HRESULT WsCloseServiceProxy(
  [in]           WS_SERVICE_PROXY       *serviceProxy,
  [in, optional] const WS_ASYNC_CONTEXT *asyncContext,
  [in, optional] WS_ERROR               *error
);

パラメーター

[in] serviceProxy

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

[in, optional] asyncContext

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

[in, optional] error

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

戻り値

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

リターン コード 説明
WS_S_ASYNC
 非同期操作はまだ保留中です。
WS_E_INVALID_OPERATION
 この操作では、サービス プロキシの現在の状態が無効です。 これは、close が失敗する唯一のエラーです。
WS_E_ENDPOINT_DISCONNECTED
 閉じる操作中に、基になる WS_CHANNEL が切断されました。 このエラーは、基になるチャネルがセッション ベースの場合にのみ発生します。
WS_E_OPERATION_ABORTED
 操作が中止されました。
WS_E_ENDPOINT_FAILURE
 リモート エンドポイントで要求を処理できませんでした。
WS_E_INVALID_FORMAT
 入力データが予期された形式でなかったか、予期された値を持っていませんでした。
WS_E_OPERATION_TIMED_OUT
 割り当てられた時間内に操作が完了しませんでした。
WS_E_QUOTA_EXCEEDED
 クォータを超えました。
E_OUTOFMEMORY
 操作を完了するにはメモリが不足しています。
E_INVALIDARG
 1 つ以上の引数が無効です。
その他のエラー
この関数は、上記以外のエラーを返す場合があります。

解説

サービス 操作の呼び出しがサービス プロキシで保留中の場合、 WsCloseServiceProxy は各呼び出しが完了するまで待機します。 WsCloseServiceProxy アプリケーションを呼び出した後は、サービス プロキシに対してこれ以上の呼び出しを実行しないでください。

WS_E_INVALID_OPERATIONが唯一であることに注意してください
終了が失敗したことを示すエラー コード。 その他のエラー コードは、操作が成功したことを示し、エラー コードは情報提供のみを目的としています。

要件

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