Share via

IX509PrivateKey：：Create 方法 (certenroll.h)

  • 项目

Create 方法创建非对称私钥。

语法

HRESULT Create();

返回值

如果函数成功，该函数将返回 S_OK。

如果函数失败，它将返回指示错误的 HRESULT 值。 可能的值包括（但并不限于）下表中的项。 有关常见错误代码的列表，请参阅 常见 HRESULT 值。

返回代码/值 说明
HRESULT_FROM_WIN32 (ERROR_BUSY)
CSP 句柄不为 NULL。
HRESULT_FROM_WIN32 (ERROR_FILE_EXISTS)
密钥已存在。

注解

如果未设置 CspStatus、 ProviderName 或 ProviderType 属性，则此方法在创建密钥时使用默认提供程序、密钥大小和 KeySpec 值。 例如，在新的操作系统安装中，Microsoft 增强型加密提供程序 v1.0 是默认提供程序。

如果未设置 ContainerName 属性，此方法将自动生成一个名称。 生成的名称包括 GUID，如果未设置 ContainerNamePrefix 属性，则为前缀“lp-”。 如果提供程序是智能卡提供程序，则生成的名称不会超过提供程序指定的 MaxKeyContainerNameLength 值。 如果生成的名称最初超过此值，则会将其截断为四十个字符。

调用 Create 或 Open 方法后，无法设置以下属性。 如果要指定它们，则必须在调用其中任一方法之前执行此操作。

要求

要求 值
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 certenroll.h
DLL CertEnroll.dll

另请参阅

IX509PrivateKey