기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
KSP(Key Storage Provider)를 사용하는 NCryptEnumKeys
NCryptEnumKeys 함수는 KSP(Key Storage Provider)에 저장된 키를 나열합니다.
Parameters
-
hProvider[in] -
키 스토리지 공급자 핸들입니다. NCryptOpenStorageProvider를 사용하여 이 핸들을 가져옵니다.
-
pszScope[in, 미사용] -
이 파라미터를 NULL로 설정합니다.
-
ppKeyName[out] -
키 이름을 저장하는
NCryptKeyName구조의 포인터 주소입니다. 사용 후 이 메모리를 해제하려면NCryptFreeBuffer를 호출합니다. ppEnumState[in, out]-
열거 진행 상황을 추적하는 VOID 포인터 주소입니다. 키 스토리지 공급자는 이 정보를 내부적으로 사용하여 열거 시퀀스를 관리합니다. 처음부터 새 열거를 시작하려면 이 포인터를 NULL로 설정합니다.
열거를 완료한 후 이 메모리를 해제하려면 이 포인터를
NCryptFreeBuffer에 전달합니다. dwFlags[in]-
함수의 동작을 수정하는 플래그입니다. 이 함수에는 플래그가 없습니다.
반환 값
이 함수는 성공 또는 실패를 나타내는 상태 코드를 반환합니다.
일반적인 반환 코드는 다음과 같습니다.
| 반환 코드 | 설명 |
|---|---|
|
ERROR_SUCCESS |
작업이 성공적으로 완료되었습니다. |
|
NTE_INVALID_PARAMETER |
하나 이상의 파라미터가 유효하지 않습니다. |
|
NTE_FAIL |
작업을 완료할 수 없습니다. |
|
NTE_INVALID_HANDLE |
|
|
NTE_NO_MORE_ITEMS |
열거에 사용 가능한 모든 키가 나열되었습니다. |
