WsOpenServiceHost 関数 (webservices.h)

  • [アーティクル]

通信用の サービス ホスト を開き、すべてのエンドポイントでリスナーを開始します。 クライアント アプリケーションは、 WsOpenSerivceHost が呼び出されるまでサービス エンドポイントに接続できません。

構文

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

パラメーター

[in] serviceHost

開く サービス ホスト オブジェクトへのポインター。 ポインターは、WsCreateServiceHost によって返される有効なWS_SERVICE_HOST オブジェクトを参照する必要があり、参照されるサービス ホストの値が NULL ではない可能性があります。

[in, optional] asyncContext

関数を非同期的に呼び出す方法に関する情報を持つ WS_ASYNC_CONTEXT オブジェクトへのポインター。 同期的にを呼び出す場合、値は NULL に設定されます。

[in, optional] error

関数 が失敗 した場合にエラーに関する追加情報を格納する必要があるWS_ERROR オブジェクトへのポインター。

戻り値

この関数は、これらの値のいずれかを返すことができます。

リターン コード 説明
WS_S_ASYNC
 非同期操作はまだ保留中です。
WS_E_OPERATION_ABORTED
 サービス ホストは、開く前、または開いている間に中止されました。
WS_E_INVALID_OPERATION
 この操作では、サービス プロキシの現在の状態が無効です。
WS_E_ADDRESS_IN_USE
 アドレスは既に使用されています。
WS_E_ADDRESS_NOT_AVAILABLE
 アドレスは、このコンテキストでは無効です。
WS_E_QUOTA_EXCEEDED
 クォータを超えました。
WS_E_OPERATION_ABORTED
 操作が中止されました。
WS_E_OPERATION_TIMED_OUT
 割り当てられた時間内に操作が完了しませんでした。
E_OUTOFMEMORY
 メモリ不足。
E_INVALIDARG
 1 つ以上の引数が無効です。
その他のエラー
この関数は、上記以外のエラーを返す場合があります。

注釈

クライアントとの通信のためにサービス ホストによってチャネルが受け入れられる前に、すべてのエンドポイント リスナーを正常に開く必要があることに注意してください。

要件

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