RegEnumValue

RegEnumValue

2015. 3. 18. 17:26
지정된 열려있는 레지스트리 키의 값을 열거한다. 호출 될 때마다 키 안의 값의 이름과 데이터를 읽어온다.


- 출처 : MSDN


  • hKey

- 열려있는 레지스트리 키에 대한 핸들을 설정한다.

- 키는 반드시 KEY_QUERY_VALUE 접근 권한으로 열려 있어야 한다.


  • dwIndex

- 읽어 올 값의 인덱스 번호를 설정한다.(번호는 0부터 시작)


  • lpValueName

- 읽어 온 값의 이름을 저장 할 메모리의 주소를 설정한다.

- 레지스트리 값 이름의 최대 사이즈는 32,767bytes 이다. 


  • lpcchValueName

- lpValueName 파라메터에 전달되는 메모리의 크기를 저장해논 메모리의 주소를 전달한다.

- 함수 호출이 끝나면 이 파라메터가 가리키는 메모리에는 널 문자를 제외한 문자의 길이가 저장된다.


  • lpReserved

- 예약된 영역으로 항상 NULL을 설정한다.


  • lpType

- 읽어 온 값의 데이터 종류를 저장할 메모리의 주소를 설정한다.

- 종류를 파악할 필요가 없을 시에는 NULL을 설정한다.


  • lpData

- 읽어 온 데이터를 저장할 메모리의 주소를 설정한다.

- 데이터를 읽어 올  필요가 없을경우 NULL을 설정한다.


  • lpcbData

- lpData 파라메터 사용 시 lpData에 설정하는 메모리의 크기를 전달하며 함수 종료 시 저장 된 문자 수가 설정된다.

- lpData를 NULL로 설정 했을시 이 파라메터 또한 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' 카테고리의 다른 글

RegGetValue  (0) 2015.03.25
RegSetValueEx  (0) 2015.03.19
RegDeleteValue  (0) 2015.03.18
RegDeleteKeyEx  (0) 2015.03.18
RegEnumKeyEx  (0) 2015.03.17

+ Recent posts