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 |