RegOpenKeyEx(A)

RegOpenKeyEx(A)

지정된 레지스트리 키를 오픈합니다.이 함수는 지정된 레지스트리 키가 존재하지 않는 경우는 키를 작성하지 않습니다.새로운 키를 작성해 오픈하는 경우에는 RegCreateKeyEx 함수를 사용합니다.

LONG RegOpenKeyExA(
    HKEY   hKey,       // 키의 핸들
    PCTSTR pSubKey,    // 오픈하는 서브 키의 이름
    DWORD  ulOptions,  // 예약(0(을)를 지정)
    REGSAM samDesired, // 시큐러티 액세스 마스크
    PHKEY  phkResult   // 핸들을 격납하는 변수의 주소
);

ADVAPI32.DLL

인수

hKey

현재 오픈되고 있는 키의 핸들을 지정합니다.

다음의 정의가 끝난 키를 지정할 수도 있습니다.

치	정의가 끝난 키
0x80000000	HKEY_CLASSES_ROOT
0x80000001	HKEY_CURRENT_USER
0x80000002	HKEY_LOCAL_MACHINE
0x80000003	HKEY_USERS
0x80000004	Windows NT/2000/XP： HKEY_PERFORMANCE_DATA
0x80000005	HKEY_CURRENT_CONFIG
0x80000006	Windows 95/98/Me： HKEY_DYN_DATA

pSubKey

오픈하는 서브 키의 이름을 나타내는 문자열의 주소를 지정합니다.하늘의 문자열("")의 주소 또는 0 (NULL) (을)를 지정했을 경우에는, hKey 파라미터로 지정한 키의 새로운 핸들을 오픈합니다.

ulOptions

예약되고 있습니다. 0 (을)를 지정하지 않으면 안됩니다.

samDesired

오픈하는 키의 핸들의 시큐러티 액세스권을 나타내는 액세스 마스크를 지정합니다.이하의 값의 편성으로 지정합니다.

치	의미
0x0001 (KEY_QUERY_VALUE)	서브 키 데이터의 문의를 허가합니다.
0x0002 (KEY_SET_VALUE)	서브 키 데이터의 설정을 허가합니다.
0x0004 (KEY_CREATE_SUB_KEY)	서브 키의 작성을 허가합니다.
0x0008 (KEY_ENUMERATE_SUB_KEYS)	서브 키의 열거를 허가합니다.
0x0010 (KEY_NOTIFY)	변경의 통지를 허가합니다.
0x0020 (KEY_CREATE_LINK)	기호 연결의 작성을 허가합니다.
0x0100 (KEY_WOW64_64KEY)	Windows XP： 64 비트 또는 32 비트 어플리케이션이, 64 비트 키를 오픈할 수 있도록 합니다.
0x0200 (KEY_WOW64_32KEY)	Windows XP： 64 비트 또는 32 비트 어플리케이션이, 32 비트 키를 오픈할 수 있도록 합니다.
0x20006 (KEY_WRITE)	STANDARD_RIGHTS_WRITE, KEY_SET_VALUE, KEY_CREATE_SUB_KEY 액세스의 편성입니다.
0x20019 (KEY_READ, KEY_EXECUTE)	STANDARD_RIGHTS_READ, KEY_QUERY_VALUE, KEY_ENUMERATE_SUB_KEYS, KEY_NOTIFY 액세스의 편성입니다.
0x1F003F (KEY_ALL_ACCESS)	STANDARD_RIGHTS_REQUIRED, KEY_QUERY_VALUE, KEY_ENUMERATE_SUB_KEYS, KEY_NOTIFY, KEY_CREATE_SUB_KEY, KEY_CREATE_LINK, KEY_SET_VALUE 액세스의 편성입니다.

phkResult

작성 또는 오픈된 키의 핸들을 격납하기 위한 변수의 주소를 지정합니다.

이 변수에 돌려주어진 핸들이 필요없게 되면, RegCloseKey 함수를 호출해 핸들을 클로우즈 하지 않으면 안됩니다.

반환값

성공하면 0 (ERROR_SUCCESS) 하지만 돌아갑니다.

실패하면 0 이외의 에러 코드가 돌아갑니다.이 에러 코드와 FORMAT_MESSAGE_FROM_SYSTEM 플래그를 지정해 FormatMessage 함수를 호출하는 것으로, 에러 메세지를 취득할 수 있습니다.

대응 정보

Windows 95 이후 / Windows NT 3.1 이후