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