RegOpenKeyExW 함수(winreg.h)

아티클
11/20/2024

지정된 레지스트리 키를 엽니다. 키 이름은 대/소문자를 구분하지 않습니다.

키에 대해 트랜잭션된 레지스트리 작업을 수행하려면 RegOpenKeyTransacted 함수를 호출합니다.

통사론

LSTATUS RegOpenKeyExW(
  [in]           HKEY    hKey,
  [in, optional] LPCWSTR lpSubKey,
  [in]           DWORD   ulOptions,
  [in]           REGSAM  samDesired,
  [out]          PHKEY   phkResult
);

매개 변수

[in] hKey

열린 레지스트리 키에 대한 핸들입니다. 이 핸들은 RegCreateKeyEx 또는 RegOpenKeyEx 함수에서 반환되거나 다음 미리 정의된 키중 하나일 수 있습니다.

HKEY_CLASSES_ROOTHKEY_CURRENT_CONFIGHKEY_CURRENT_USERHKEY_LOCAL_MACHINEHKEY_USERS

[in, optional] lpSubKey

열 레지스트리 하위 키의 이름입니다.

키 이름은 대/소문자를 구분하지 않습니다.

lpSubKey 매개 변수가 NULL 또는 빈 문자열에 대한 포인터를 hKey 미리 정의된 키인 경우 시스템은 미리 정의된 키를 새로 고치고 phkResult 함수에 전달된 동일한 hKey 처리합니다. 그렇지 않으면 phkResult 열린 키에 대한 새 핸들을 받습니다.

자세한 내용은 Registry 요소 크기 제한참조하세요.

[in] ulOptions

키를 열 때 적용할 옵션을 지정합니다. 이 매개 변수를 0 또는 다음으로 설정합니다.

값	의미
REG_OPTION_OPEN_LINK	키는 기호 링크입니다. 레지스트리 기호 링크는 반드시 필요한 경우에만 사용해야 합니다.

[in] samDesired

열 키에 대한 원하는 액세스 권한을 지정하는 마스크입니다. 키의 보안 설명자가 호출 프로세스에 대해 요청된 액세스를 허용하지 않으면 함수가 실패합니다. 자세한 내용은 레지스트리 키 보안 및 액세스 권한참조하세요.

[out] phkResult

열린 키에 대한 핸들을 받는 변수에 대한 포인터입니다. 키가 미리 정의된 레지스트리 키 중 하나가 아닌 경우 핸들 사용을 마친 후 RegCloseKey 함수를 호출합니다.

반환 값

함수가 성공하면 반환 값이 ERROR_SUCCESS.

함수가 실패하면 반환 값은 Winerror.h에 정의된 0이 아닌 오류 코드입니다. FormatMessage 함수를 FORMAT_MESSAGE_FROM_SYSTEM 플래그와 함께 사용하여 오류에 대한 일반적인 설명을 가져올 수 있습니다.

발언

RegCreateKeyEx 함수와 달리 RegOpenKeyEx 함수는 레지스트리에 키가 없는 경우 지정된 키를 만들지 않습니다.

특정 레지스트리 작업은 키에 대한 핸들을 가져올 때 지정된 액세스 마스크가 아니라 키의 보안 설명자에 대한 액세스 검사를 수행합니다. 예를 들어 KEY_READ samDesired 사용하여 키를 열더라도 키의 보안 설명자가 허용하는 경우 레지스트리 키를 만드는 데 사용할 수 있습니다. 반면, RegSetValueEx 함수는 특히 KEY_SET_VALUE 액세스 권한으로 키를 열어야 합니다.

서비스 또는 애플리케이션이 다른 사용자를 가장하는 경우 HKEY_CURRENT_USER이 함수를 사용하지 마세요. 대신 RegOpenCurrentUser 함수를 호출합니다.

특정 레지스트리 키에 액세스하는 작업은 리디렉션됩니다. 자세한 내용은 레지스트리레지스트리 가상화 및 32비트 및 64비트 애플리케이션 데이터를 참조하세요.

예제

lResult = RegOpenKeyEx (hKeyRoot, lpSubKey, 0, KEY_READ, &hKey);

if (lResult != ERROR_SUCCESS) 
{
    if (lResult == ERROR_FILE_NOT_FOUND) {
        printf("Key not found.\n");
        return TRUE;
    } 
    else {
        printf("Error opening key.\n");
        return FALSE;
    }
}

컨텍스트에서 이 예제를 보려면 하위 키사용하여 키 삭제 참조하세요.

메모

winreg.h 헤더는 REgOpenKeyEx를 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입대한 규칙을 참조하세요.

요구 사항

요구	값
지원되는 최소 클라이언트	Windows 2000 Professional [데스크톱 앱만 해당]
지원되는 최소 서버	Windows 2000 Server [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	winreg.h(Windows.h 포함)
라이브러리	Advapi32.lib
DLL	Advapi32.dll