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

  • [アーティクル]

SetCAProperty メソッドは、証明機関 (CA) のプロパティ値を設定します。

構文

HRESULT SetCAProperty(
  [in] const BSTR strConfig,
  [in] LONG       PropId,
  [in] LONG       PropIndex,
  [in] LONG       PropType,
  [in] VARIANT    *pvarPropertyValue
);

パラメーター

[in] strConfig

COMPUTERNAME\CANAME 形式の CA の有効な構成文字列を表す文字列値。COMPUTERNAME は証明書サービス サーバーのネットワーク名、CANAME は証明書サービスのセットアップ時に入力された CA の共通名です。 構成文字列名の詳細については、「 ICertConfig」を参照してください。

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

 

[in] PropId

次のいずれかのプロパティ識別子を指定します。

読み取り専用のプロパティを含むすべての CA プロパティの詳細については、「 ICertAdmin2::GetCAProperty」を参照してください。

値 意味
CR_PROP_KRACERT
 CA のキー回復エージェント (KRA) 証明書。

データ形式: バイナリ、インデックス付き。
CR_PROP_KRACERTCOUNT
 CA の KRA 証明書の数。

データ形式: 長整数型 (Long) の値を使用します。
CR_PROP_KRACERTUSEDCOUNT
 CA によって使用される KRA 証明書の数。

データ形式: 長整数型 (Long) の値を使用します。
CR_PROP_ROLESEPARATIONENABLED
 ロールの分離を有効にするかどうかを示す値。

データ形式: 長整数型 (Long) の値を使用します。
CR_PROP_TEMPLATES
 CA でサポートされているテンプレートの一覧。

データ形式: 文字列。

[in] PropIndex

PropId パラメーターにインデックスが付いている場合、プロパティ値を取得するときに使用する 0 から始まるインデックス。 PropId がインデックス付けされていない場合、この値は無視されます。

[in] PropType

プロパティの型を指定します。 このパラメーターには、次の値のいずれかを指定できます。

値 意味
PROPTYPE_LONG
 署名された 長い データ。
PROPTYPE_DATE
 日付/時刻 (将来の使用のために予約済み)。
PROPTYPE_BINARY
 バイナリ データ。
PROPTYPE_STRING
 Unicode文字列 データ。

[in] pvarPropertyValue

C++ プロパティ値を指定する VARIANT へのポインター。
VB プロパティ値を指定する バリアント型 (Variant) の値です。

戻り値

VB

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

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

要件

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

こちらもご覧ください

ICertAdmin2

ICertAdmin2::GetCAProperty