RegEnumKeyEx

2015. 3. 17. 19:11

지정된 열려있는 레지스트리 키의 하위 키를 열거한다.


- 출처 : 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

+ Recent posts