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

# KSP(Key Storage Provider)를 사용하는 NCryptEnumKeys
<a name="ksp-library-apis-enum-keys"></a>

NCryptEnumKeys 함수는 KSP(Key Storage Provider)에 저장된 키를 나열합니다.

## Parameters
<a name="ksp-library-apis-enum-keys-parameters"></a>

 `hProvider` [in]   
키 스토리지 공급자 핸들입니다. [`NCryptOpenStorageProvider`](ksp-library-apis-open-provider.md)를 사용하여 이 핸들을 가져옵니다.

 `pszScope` [in, 미사용]   
 이 파라미터를 NULL로 설정합니다.

 `ppKeyName` [out]   
키 이름을 저장하는 `NCryptKeyName` 구조의 포인터 주소입니다. 사용 후 이 메모리를 해제하려면 `NCryptFreeBuffer`를 호출합니다.

`ppEnumState` [in, out]  
열거 진행 상황을 추적하는 VOID 포인터 주소입니다. 키 스토리지 공급자는 이 정보를 내부적으로 사용하여 열거 시퀀스를 관리합니다. 처음부터 새 열거를 시작하려면 이 포인터를 NULL로 설정합니다.  
열거를 완료한 후 이 메모리를 해제하려면 이 포인터를 `NCryptFreeBuffer`에 전달합니다.

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

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

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

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


****  

| 반환 코드 | 설명 | 
| --- | --- | 
|  ERROR\$1SUCCESS  |  작업이 성공적으로 완료되었습니다.  | 
|  NTE\$1INVALID\$1PARAMETER  |  하나 이상의 파라미터가 유효하지 않습니다.  | 
|  NTE\$1FAIL  |  작업을 완료할 수 없습니다.  | 
|  NTE\$1INVALID\$1HANDLE  |  `hProvider`의 핸들이 유효하지 않습니다.  | 
|  NTE\$1NO\$1MORE\$1ITEMS  |  열거에 사용 가능한 모든 키가 나열되었습니다.  |