RegGetValue

지정한 레지스트리 값의 타입과 데이터를 읽어온다.

- 출처 : MSDN

• hkey

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

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

• lpSubKey

- 값을 읽어올 hkey 파라메터의 하위 키를 설정한다.

- 대/소문자를 구분하지 않는다.

• lpValue

- 읽어올 값의 이름을 설정한다.

- 이 파라메터의 값을 NULL 또는 빈 문자열("")로 설정 시 키 안의 이름이 없는 값 또는 기본 값을 읽어온다.

• dwFlags

- 읽어 올 값의 종류를 제한한다.

- 읽어 올 타입의 종류를 제한하지 않을 때 RRF_RT_ANY를 설정한다.

//

// RRF - Registry Routine Flags (for RegGetValue)

//

#define RRF_RT_REG_NONE        0x00000001  // restrict type to REG_NONE      

(other data types will not return ERROR_SUCCESS)

#define RRF_RT_REG_SZ          0x00000002  // restrict type to REG_SZ        

(other data types will not return ERROR_SUCCESS) (automatically converts REG_EXPAND_SZ to REG_SZ unless RRF_NOEXPAND is specified)

#define RRF_RT_REG_EXPAND_SZ   0x00000004  // restrict type to REG_EXPAND_SZ 

(other data types will not return ERROR_SUCCESS) (must specify RRF_NOEXPAND or RegGetValue will fail with ERROR_INVALID_PARAMETER)

#define RRF_RT_REG_BINARY      0x00000008  // restrict type to REG_BINARY    

(other data types will not return ERROR_SUCCESS)

#define RRF_RT_REG_DWORD       0x00000010  // restrict type to REG_DWORD    

(other data types will not return ERROR_SUCCESS)

#define RRF_RT_REG_MULTI_SZ    0x00000020  // restrict type to REG_MULTI_SZ  

(other data types will not return ERROR_SUCCESS)

#define RRF_RT_REG_QWORD       0x00000040  // restrict type to REG_QWORD     

(other data types will not return ERROR_SUCCESS)

#define RRF_RT_DWORD           (RRF_RT_REG_BINARY | RRF_RT_REG_DWORD) // restrict type to *32-bit* RRF_RT_REG_BINARY or RRF_RT_REG_DWORD 

(other data types will not return ERROR_SUCCESS)

#define RRF_RT_QWORD           (RRF_RT_REG_BINARY | RRF_RT_REG_QWORD) // restrict type to *64-bit* RRF_RT_REG_BINARY or RRF_RT_REG_DWORD 

(other data types will not return ERROR_SUCCESS)

#define RRF_RT_ANY             0x0000ffff       // no type restriction

#define RRF_NOEXPAND           0x10000000  // do not automatically expand environment strings if value is of type REG_EXPAND_SZ

#define RRF_ZEROONFAILURE      0x20000000  // if pvData is not NULL, set content to all zeros on failure

- 출처 : WinReg.h

• pdwType

- 저장 된 값의 종류를 나타내는 코드를 저장 할 메모리의 주소를 설정한다.

- 값의 종류를 파악할 필요 없을 경우 NULL을 설정한다.

#define REG_NONE                    ( 0 )   // No value type

#define REG_SZ                      ( 1 )   // Unicode nul terminated string

#define REG_EXPAND_SZ               ( 2 )   // Unicode nul terminated string

                                            // (with environment variable references)

#define REG_BINARY                  ( 3 )   // Free form binary

#define REG_DWORD                   ( 4 )   // 32-bit number

#define REG_DWORD_LITTLE_ENDIAN     ( 4 )   // 32-bit number (same as REG_DWORD)

#define REG_DWORD_BIG_ENDIAN        ( 5 )   // 32-bit number

#define REG_LINK                    ( 6 )   // Symbolic Link (unicode)

#define REG_MULTI_SZ                ( 7 )   // Multiple Unicode strings

#define REG_RESOURCE_LIST           ( 8 )   // Resource list in the resource map

#define REG_FULL_RESOURCE_DESCRIPTOR ( 9 )  // Resource list in the hardware description

#define REG_RESOURCE_REQUIREMENTS_LIST ( 10 )

#define REG_QWORD                   ( 11 )  // 64-bit number

#define REG_QWORD_LITTLE_ENDIAN     ( 11 )  // 64-bit number (same as REG_QWORD)

- 출처 : WinNT.h

• pvData

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

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

• pcbData
  

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

- pvData를 NULL로 설정 했을시 이 파라메터 또한 NULL을 설정한다.

Return value : 성공 시 ERROR_SUCCESS(0)을 반환하고 pvData에 설정된 메모리의 크기가 저장 하려는 데이터의 크기보다 작을 시에는 ERROR_MORE_DATA(234), 실패 시 0이 아닌 Winerror.h에 정의 되어 있는 에러 코드를 반환한다.

Header : Winreg.h(include Windows.h)

DLL : Advapi32.dll