IOCSPAdmin::GetConfiguration メソッド (certadm.h)

GetConfiguration メソッドは、オンライン証明書状態プロトコル (OCSP) レスポンダー サーバーに接続し、サーバーからの構成情報を使用して OCSPAdmin オブジェクトを初期化します。

構文

HRESULT GetConfiguration(
  [in] const BSTR   bstrServerName,
  [in] VARIANT_BOOL bForce
);

パラメーター

[in] bstrServerName

レスポンダー サーバー名を含む文字列。

[in] bForce

C++	OCSP レスポンダー サービスの実行中のインスタンスが見つからないときに、呼び出し元がサーバーのレジストリからレスポンダー構成を読み取る場合にVARIANT_TRUEします。それ以外の場合 は、VARIANT_FALSE。
VB	TRUE を指定 すると、OCSP レスポンダー サービスの実行中のインスタンスが見つからないときに、呼び出し元がサーバーのレジストリからレスポンダー構成を読み取ります。それ以外の場合 は False。

戻り値

VB

メソッドが成功すると、 S_OKが返されます。

メソッドが失敗した場合は、エラーを示す HRESULT 値を返します。 一般的なエラー コードの一覧については、「 共通の HRESULT 値」を参照してください。

メソッドが HRESULT_FROM_WIN32(ERROR_INVALID_STATE) を返す場合、構成は既に初期化されています。

メソッドが E_INVALIDARGを返す場合、 pVal パラメーターは NULL に設定されました。

注釈

次の表に、 bForce パラメーター値がメソッド呼び出しに及ぼす影響を示します。

ターゲット サーバー上の OCSP レスポンダー サービス	bForce が VARIANT_TRUE	bForce が VARIANT_FALSE
実行中	サービスから構成を取得します。	サービスから構成を取得します。
停止済み	サーバー レジストリから構成の取得を試みます。 この試行が失敗した場合は、エラーを返します。	エラーを返します。

 

次の表に、 bForce パラメーター値がメソッド呼び出しに及ぼす影響を示します。

ターゲット サーバー上の OCSP レスポンダー サービス	bForce は True です	bForce は False です
実行中	サービスから構成を取得します。	サービスから構成を取得します。
停止済み	サーバー レジストリから構成の取得を試みます。 この試行が失敗した場合は、エラーを返します。	エラーを返します。

 

このメソッドは、OCSP レスポンダー サービスの実行中のインスタンスから構成の読み取りを試みますが、サービスが実行されていないか、アクセスできない状態にある場合は、それができない可能性があります。 呼び出し元は、実行中のインスタンスが見つからない場合に、サーバーのレジストリから構成を読み取るようメソッドに指示できます。

メソッドは、特定の OCSPAdmin オブジェクトに対して複数回呼び出そうとすると失敗します。 OCSPAdmin の各インスタンスは、1 つのレスポンダー サーバーに対応します。 OCSP レスポンダー サーバーの配列内の別のサーバーに接続するには、 OCSPAdmin オブジェクトの新しいインスタンスを作成します。

要件

要件	値
サポートされている最小のクライアント	サポートなし
サポートされている最小のサーバー	Windows Server 2008 Datacenter、Windows Server 2008 Enterprise [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	certadm.h (Certsrv.h を含む)
Library	Certadm.lib
[DLL]	Certadm.dll

こちらもご覧ください

IOCSPAdmin