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 |