次の方法で共有


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 レスポンダー サービス bForceVARIANT_TRUE bForceVARIANT_FALSE
実行中 サービスから構成を取得します。 サービスから構成を取得します。
停止済み サーバー レジストリから構成の取得を試みます。 この試行が失敗した場合は、エラーを返します。 エラーを返します。
 

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

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

このメソッドは、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