IX509PrivateKey::Create メソッド (certenroll.h)

Create メソッドは非対称秘密キーを作成します。

構文

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
• 説明
• Existing
• ExportPolicy
• FriendlyName
• KeyProtection
• KeySpec
• KeyUsage
• LegacyCsp
• Length
• MachineContext
• ProviderName
• ProviderType
• ピン留め
• ReaderName
• Silent
• UIContextMessage

要件

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	certenroll.h
[DLL]	CertEnroll.dll

こちらもご覧ください

IX509PrivateKey