RegEnumKeyEx
지정된 열려있는 레지스트리 키의 하위 키를 열거한다.
- 출처 : MSDN
hKey
- 열려있는 레지스트리 키에 대한 핸들을 설정한다.
- 키는 KEY_ENUMERATE_SUB_KEYS 접근 권한으로 열려 있어야 한다.
dwIndex
- 읽어 올 하위 키의 인덱스 번호를 설정한다.(번호는 0부터 시작)
lpName
- 읽어 온 키의 이름을 저장 할 메모리의 주소를 설정한다.
- 루트(하이브) 키를 포함한 키의 전체 경로의 길이는 최대 255 글자이다.
lpcName
- lpName 파라메터에 전달되는 메모리의 크기를 저장해논 메모리의 주소를 전달한다.
- 함수 호출이 끝나면 이 파라메터가 가리키는 메모리에는 널 문자를 제외한 문자의 길이가 저장된다.
lpReserved
- 예약된 영역으로 항상 NULL로 설정한다.
lpClass
- 사용자 정의 클래스 유형을 설정한다.
- 일반적으로 NULL을 설정한다.
lpcClass
- lpClass 파라메터 사용 시 lpClass에 설정하는 메모리의 크기를 전달하며 함수 종료 시 실제 문자 수가 저장된다.
- lpClass를 NULL로 설정 했을시 이 파라메터 또한 NULL을 설정한다.
lpftLastWriteTime
- 열거하는 하위 키의 마지막 작성 시간을 저장하기 위한 FILETIME 구조체 변수의 주소를 전달한다.
- 일반적으로 NULL로 설정한다.
Return value : 성공 시 ERROR_SUCCESS(0)을 반환하고 더 이상 열거 가능한 하위 키가 없을 시에는 ERROR_NO_MORE_ITEMS(259), 실패 시 0이 아닌 Winerror.h에 정의 되어 있는 에러 코드를 반환한다.
Header : Winreg.h(include Windows.h)
DLL : Advapi32.dll
'Win32 API' 카테고리의 다른 글
RegDeleteValue (0) | 2015.03.18 |
---|---|
RegDeleteKeyEx (0) | 2015.03.18 |
RegDeleteKey (0) | 2015.03.17 |
RegFlushKey (0) | 2015.03.17 |
RegCloseKey (0) | 2015.03.17 |