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

SetConfiguration メソッドは、構成を変更してレスポンダー サービスを更新します。

構文

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

パラメーター

[in] bstrServerName

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

[in] bForce

C++	サービス がオフラインまたは使用できないときに、メソッドがレスポンダー サービス レジストリを更新する必要があるかどうかをVARIANT_TRUEします。それ以外の場合 は、VARIANT_FALSE。 サービスがオフラインまたは使用不可で 、bForce パラメーターが VARIANT_TRUEされている場合、 SetConfiguration はレスポンダー サービス レジストリを直接更新します。
VB	True を指定 すると、サービスがオフラインまたは使用できないときに、メソッドがレスポンダー サービス レジストリを更新する必要があります。それ以外の場合 は False。 サービスがオフラインまたは利用不可で 、bForce パラメーターが True の場合、 SetConfiguration はレスポンダー サービス レジストリを直接更新します。

戻り値

VB

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

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

注釈

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

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

 

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

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

要件

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

こちらもご覧ください

IOCSPAdmin