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

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

`NCryptOpenKey` 함수는 KSP(Key Storage Provider)에 있는 키를 엽니다.

## Parameters
<a name="ksp-library-apis-open-key-parameters"></a>

 `hProvider` [in]   
해당 키를 포함하는 KSP 핸들입니다. [`NCryptOpenStorageProvider`](ksp-library-apis-open-provider.md)를 사용하여 핸들을 가져옵니다.

 `phKey` [out]   
키 핸들을 저장하는 `NCRYPT_KEY_HANDLE` 변수에 대한 포인터입니다.

`pszKeyName` [in]  
키 이름을 포함하는 Null로 종료된 유니코드 문자열에 대한 포인터입니다.

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

`dwFlags` [in]  
함수의 동작을 수정하는 플래그입니다. 이 함수에는 플래그가 정의되지 않습니다.

## 반환 값
<a name="ksp-library-apis-open-key-return-value"></a>

이 함수는 성공 또는 실패를 나타내는 상태 코드를 반환합니다.

일반적인 반환 코드는 다음과 같습니다.


****  

| 반환 코드 | 설명 | 
| --- | --- | 
| ERROR\_SUCCESS | 작업이 성공적으로 완료되었습니다. | 
| NTE\_INVALID\_PARAMETER | 하나 이상의 파라미터가 유효하지 않습니다. | 
| NTE\_FAIL | 작업을 완료할 수 없습니다. | 
| NTE\_INVALID\_HANDLE | `hProvider`의 핸들이 유효하지 않습니다. | 
| NTE\_BAD\_KEYSET | 제공된 키 이름이 고유한 결과를 반환하지 않았습니다. |