기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

# KSP(Key Storage Provider)를 사용하는 NCryptCreatePersistedKey
<a name="ksp-library-apis-create-persisted-key"></a>

`NCryptCreatePersistedKey` 함수는 새 키를 생성하여 KSP(Key Storage Provider)에 저장합니다. [`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로 종료된 유니코드 문자열에 대한 포인터입니다.  
AWS CloudHSM 키 스토리지 공급자(KSP)는 다음 알고리즘을 지원합니다.    
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/cloudhsm/latest/userguide/ksp-library-apis-create-persisted-key.html)

`pszKeyName` [in, 선택 사항]  
키 이름을 포함하는 Null로 종료된 유니코드 문자열에 대한 포인터입니다. 이 파라미터가 NULL인 경우 이 함수는 지속되지 않는 임시 키를 생성합니다.

`dwLegacyKeySpec` [in, 미사용]  
AWS CloudHSM 키 스토리지 공급자(KSP)는이 파라미터를 사용하지 않습니다.

`dwFlags` [in]  
함수의 동작을 수정하는 플래그입니다. 다음 값 중 0개 이상을 사용합니다.    
****    
[\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/ko_kr/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  |  하나 이상의 파라미터가 유효하지 않습니다.  | 
|  NTE\$1FAIL  |  작업을 완료할 수 없습니다.  | 
|  NTE\$1BAD\$1FLAGS  |  `dwFlags` 파라미터에 유효하지 않은 값이 있습니다.  | 
|  NTE\$1NOT\$1SUPPORTED  |  `pszAlgId` 파라미터에 지원되지 않는 값이 포함되어 있습니다.  | 
|  NTE\$1EXISTS  |  지정된 이름의 키가 이미 존재하며 작업에서 ` NCRYPT_OVERWRITE_KEY_FLAG`를 사용하지 않았습니다.  |