ICertAdmin2::SetConfigEntry メソッド (certadm.h)

  • [アーティクル]

SetConfigEntry メソッドは、証明機関 (CA) の構成情報を設定します。

構文

HRESULT SetConfigEntry(
  [in] const BSTR strConfig,
  [in] const BSTR strNodePath,
  [in] const BSTR strEntryName,
  [in] VARIANT    *pvarEntry
);

パラメーター

[in] strConfig

COMPUTERNAME\CANAME 形式の CA の有効な構成文字列を表す文字列値。COMPUTERNAME は証明書サービス サーバーのネットワーク名、CANAME は証明書サービスのセットアップ時に入力された CA の共通名です。 構成文字列名の詳細については、「 ICertConfig」を参照してください。 このパラメーターには空の文字列を指定できます。この場合、関数は CA に固有ではない構成情報を設定します。 このパラメーターを NULL にすることはできません。

重要SetConfigEntry は、構成文字列が変更されたときに内部キャッシュをクリアしません。 CA の構成文字列を変更する場合は、新しい ICertAdmin オブジェクトをインスタンス化し、このメソッドを新しい構成文字列で再度呼び出す必要があります。
 

[in] strNodePath

構成情報のノード パスを表す文字列値。 このパラメーターには空の文字列を指定できます。この場合、関数は strConfig によって識別されるパスから構成情報を取得します。 このパラメーターを NULL にすることはできません。

[in] strEntryName

情報が設定されているエントリの名前を表す文字列値。 この値には空の文字列を指定できます。この場合、既定のエントリは設定されているエントリです。 このパラメーターを NULL にすることはできません。

[in] pvarEntry

C++ 設定する情報を指定する VARIANT へのポインター。 この値が空の場合、指定されたキーは削除されます。
VB 設定する情報を指定するバリアント型 (Variant) の値を指定します。 この値が空の場合、指定されたキーは削除されます。

戻り値

VB

関数が成功した場合、戻り値はS_OK。

関数が失敗した場合、戻り値はエラーを示す HRESULT です。 一般的なエラー コードの一覧については、「 共通 HRESULT 値」を参照してください。

解説

構成情報は、次のパスの下のレジストリに格納されます。

Hkey_local_machine\システム\CurrentControlSet\サービス\CertSvc\構成\[CASANITIZEDNAME]\[strNodePath]\[strEntryName]

ここで、CASANITIZEDNAME は CA のサニタイズされた名前です。 サニタイズされた名前の詳細については、「 ICertConfig2::GetConfig」を参照してください。

要件

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

関連項目

ICertAdmin2