IX509PrivateKey：：Create 方法 (certenroll.h)

Create 方法會建立非對稱私鑰。

Syntax

HRESULT Create();

傳回值

如果函式成功，函式會傳回 S_OK。

如果函式失敗，它會傳回 指出錯誤的 HRESULT 值。 可能的值包括 (但不限於) 下表中的這些值。 如需常見錯誤碼的清單，請參閱 一般 HRESULT 值。

傳回碼/值	Description
HRESULT_FROM_WIN32 (ERROR_BUSY)	CSP 句柄不是 NULL。
HRESULT_FROM_WIN32 (ERROR_FILE_EXISTS)	索引鍵已經存在。

備註

如果您未設定 CspStatus、 ProviderName 或 ProviderType 屬性，這個方法會在建立密鑰時使用預設提供者、密鑰大小和 KeySpec 值。 例如，在新的操作系統安裝上，Microsoft Enhanced Cryptographic Provider v1.0 是預設提供者。

如果您未設定 ContainerName 屬性，此方法會自動產生名稱。 產生的名稱包含 GUID，如果未設定 ContainerNamePrefix 屬性，則為 “lp-” 前置詞。 如果提供者是智慧卡提供者，產生的名稱將不會超過提供者所指定的 MaxKeyContainerNameLength 值。 如果產生的名稱一開始超過此值，則會截斷為 40 個字元。

呼叫 Create 或 Open 方法之後，您無法設定下列屬性。 如果您想要指定它們，您必須先這麼做，才能呼叫其中一種方法。

• 演算法
• ContainerName
• ContainerNamePrefix
• CspInformations
• CspStatus
• 描述
• 現有的
• ExportPolicy
• FriendlyName
• KeyProtection
• KeySpec
• KeyUsage
• LegacyCsp
• 長度
• MachineContext
• ProviderName
• ProviderType
• 針
• ReaderName
• 沉默
• UIContextMessage

規格需求

需求	值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]
目標平台	Windows
標頭	certenroll.h
Dll	CertEnroll.dll

另請參閱

IX509PrivateKey