WsCloseServiceHost 関数 (webservices.h)

  • [アーティクル]

指定した サービス ホストとの通信を閉じます。

構文

HRESULT WsCloseServiceHost(
  [in]           WS_SERVICE_HOST        *serviceHost,
  [in, optional] const WS_ASYNC_CONTEXT *asyncContext,
  [in, optional] WS_ERROR               *error
);

パラメーター

[in] serviceHost

閉じるサービス ホストを表す WS_SERVICE_HOST 構造体へのポインター。

[in, optional] asyncContext

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

[in, optional] error

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

戻り値

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

リターン コード 説明
WS_S_ASYNC
 非同期操作はまだ保留中です。
WS_E_INVALID_OPERATION
 この操作では、サービス ホストの現在の状態が無効です。
E_INVALIDARG
 1 つ以上の引数が無効です。
WS_E_OPERATION_TIMED_OUT
 割り当てられた時間内に操作が完了しませんでした。
WS_E_OPERATION_ABORTED
 操作が中止されました。
その他のエラー
この関数は、上記以外のエラーを返す場合があります。

注釈

WsCloseServiceHost は 、サービス ホスト上のすべてのリスナーを閉じます。 その結果、クライアントから新しいチャネルは受け入れわれません。 ただし、既に受け入れ済みのチャネルでの保留中の I/O の完了は許可されます。

これは、セッション ベースのチャネル バインドで実行するように構成されたエンドポイントに影響します。 クライアントがこのようなエンドポイント上のサービスとのオープン セッションを持っている場合、クライアントがサービスとのセッションを閉じるまで、クローズは完了しません。

要件

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