RegOpenKeyExA 함수(winreg.h)

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

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

통사론

LSTATUS RegOpenKeyExA(
  [in]           HKEY   hKey,
  [in, optional] LPCSTR 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 또는 다음으로 설정합니다.

[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;
    }
}

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

요구 사항

참고 항목

RegCloseKey

RegCreateKeyEx

RegDeleteKey

regOpenKeyTransacted

레지스트리 함수

레지스트리 개요