翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# キーストレージプロバイダー (KSP) を使用した NCryptCreatePersistedKey
<a name="ksp-library-apis-create-persisted-key"></a>

`NCryptCreatePersistedKey` 関数は、新しいキーを作成し、それをキーストレージプロバイダー (KSP) に保存します。キーを作成した後、[`NCryptSetProperty`](ksp-library-apis-set-property.md) 関数を使用してそのプロパティを設定できます。キーを使用する前に、[`NCryptFinalizeKey`](ksp-library-apis-finalize-key.md) を呼び出す必要があります。

## パラメータ
<a name="ksp-library-apis-create-persisted-key-parameters"></a>

 `hProvider` [in]   
キーを作成するキーストレージプロバイダーのハンドル。このハンドルは、[`NCryptOpenStorageProvider`](ksp-library-apis-open-provider.md) を使用して取得します。

 `phKey` [out]   
キーハンドルを収納する `NCRYPT_KEY_HANDLE` 変数のアドレス。

 `pszAlgId` [in]   
キーを作成するための暗号アルゴリズム識別子を指定する、null 終端された Unicode 文字列へのポインタ。  
AWS CloudHSM Key Storage Provider (KSP) は、次のアルゴリズムをサポートしています。    
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/cloudhsm/latest/userguide/ksp-library-apis-create-persisted-key.html)

`pszKeyName` [in, optional]  
キー名を含む null 終端された Unicode 文字列へのポインタ。このパラメータが NULL の場合、この関数は永続化されない一時キーを作成します。

`dwLegacyKeySpec` [in, unused]  
AWS CloudHSM Key Storage Provider (KSP) はこのパラメータを使用しません。

`dwFlags` [in]  
関数の動作を変更するためのフラグ。以下の値を 0 個以上使用します。    
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ja_jp/cloudhsm/latest/userguide/ksp-library-apis-create-persisted-key.html)

## 戻り値
<a name="ksp-library-apis-create-persisted-key-return-value"></a>

この関数は、成功または失敗を示すステータスコードを返します。

一般的なリターンコードは次のとおりです。


****  

| リターンコード | 説明 | 
| --- | --- | 
|  ERROR\$1SUCCESS  |  関数は正常に完了しました。  | 
|  NTE\$1INVALID\$1PARAMETER  |  1 つ以上のパラメータが無効です。  | 
|  NTE\$1FAIL  |  オペレーションを完了できませんでした。  | 
|  NTE\$1BAD\$1FLAGS  |  `dwFlags` パラメータに無効な値が含まれています。  | 
|  NTE\$1NOT\$1SUPPORTED  |  `pszAlgId` パラメータにサポートされていない値が含まれています。  | 
|  NTE\$1EXISTS  |  指定された名前のキーは既に存在し、オペレーションは ` NCRYPT_OVERWRITE_KEY_FLAG` を使用しませんでした。  |