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 方法后，无法设置以下属性。 如果要指定它们，则必须在调用其中任一方法之前执行此操作。

• 算法
• ContainerName
• ContainerNamePrefix
• CspInformations
• CspStatus
• 说明
• 现有
• ExportPolicy
• FriendlyName
• KeyProtection
• KeySpec
• KeyUsage
• LegacyCsp
• 时长
• MachineContext
• ProviderName
• ProviderType
• 针
• ReaderName
• Silent
• UIContextMessage

要求

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

另请参阅

IX509PrivateKey