IX509CertificateRequestPkcs10::get_KeyContainerNamePrefix メソッド (certenroll.h)
KeyContainerNamePrefix プロパティは、新しい秘密キーのコンテナー名を作成するために使用されるプレフィックスを指定または取得します。
このプロパティは読み取り/書き込み可能です。
構文
HRESULT get_KeyContainerNamePrefix(
BSTR *pValue
);
パラメーター
pValue
戻り値
なし
解説
各 CryptoAPI 暗号化サービス プロバイダー または暗号化 API: 次世代 (CNG) キー プロバイダーは、秘密キーのキー コンテナーを保持します。 既存のキーのキー コンテナーの名前を取得するには、IX509PrivateKey オブジェクトの ContainerName プロパティを使用します。
プレフィックスには、キー コンテナー名の最大長と有効なコンテナー名文字に制限される任意の文字列を含めることができます。 たとえば、 ContainerName プロパティを呼び出してキー コンテナー名を指定しない場合、秘密キーの作成時に自動的に作成され、コンテナー名のプレフィックスは文字列 "lp" になります。 別の例として、テスト ハーネスを作成していて、キー コンテナーを生成したプログラムによって区別する場合は、実行可能ファイルの名前をプレフィックスとして使用できます。
Encode メソッドを呼び出す前にこのプロパティを設定し、このプロパティを呼び出す前に IX509CertificateRequestPkcs10 オブジェクトを初期化する必要があります。 詳細については、次のいずれかの方法を参照してください。
- InitializeDecode
- InitializeFromCertificate
- InitializeFromPrivateKey
- InitializeFromPublicKey
- InitializeFromTemplateName
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | certenroll.h |
[DLL] | CertEnroll.dll |