RegOpenUserClassesRoot 함수(winreg.h)

아티클
03/08/2023

지정된 사용자의 HKEY_CLASSES_ROOT 키에 대한 핸들을 검색합니다. 사용자는 액세스 토큰으로 식별됩니다. 반환된 키에는 HKEY_LOCAL_MACHINE\Software\Classes 키의 내용을 사용자의 레지스트리 하이브에 있는 Software\Classes 키의 내용과 병합하는 레지스트리 보기가 있습니다. 자세한 내용은 HKEY_CLASSES_ROOT 키를 참조하세요.

구문

LSTATUS RegOpenUserClassesRoot(
  [in]  HANDLE hToken,
        DWORD  dwOptions,
  [in]  REGSAM samDesired,
  [out] PHKEY  phkResult
);

매개 변수

[in] hToken

관심 있는 사용자를 식별하는 기본 또는 가장 액세스 토큰에 대한 핸들입니다. LogonUser, CreateRestrictedToken, DuplicateToken, DuplicateTokenEx, OpenProcessToken 또는 OpenThreadToken 함수에 대한 호출에서 반환되는 토큰 핸들일 수 있습니다.

핸들에는 TOKEN_QUERY 액세스 권한이 있어야 합니다. 자세한 내용은 Access-Token 개체에 대한 액세스 권한을 참조하세요.

dwOptions

이 매개 변수는 예약되어 있으며 0이어야 합니다.

[in] samDesired

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

[out] phkResult

열린 키에 대한 핸들을 수신하는 변수에 대한 포인터입니다. 반환된 핸들이 더 이상 필요하지 않으면 RegCloseKey 함수를 호출하여 닫습니다.

반환 값

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

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

설명

RegOpenUserClassesRoot 함수를 사용하면 대화형 사용자 이외의 사용자에 대해 병합된 HKEY_CLASSES_ROOT 정보를 검색할 수 있습니다. 예를 들어 클라이언트/서버 애플리케이션의 서버 구성 요소는 RegOpenUserClassesRoot 를 사용하여 클라이언트에 대한 병합된 정보를 검색할 수 있습니다.

지정된 사용자의 사용자 프로필이 로드되지 않으면 RegOpenUserClassesRoot가 실패합니다. 사용자가 대화형으로 로그온하면 시스템에서 자동으로 사용자의 프로필을 로드합니다. 다른 사용자의 경우 LoadUserProfile 함수를 호출하여 사용자의 프로필을 로드할 수 있습니다. 그러나 LoadUserProfile 은 시간이 많이 걸릴 수 있으므로 사용자의 병합된 HKEY_CLASSES_ROOT 정보가 반드시 필요한 경우가 아니면 이 용도로 호출하지 마세요.

대화형 로그온 사용자의 보안 컨텍스트에서 실행되는 애플리케이션은 RegOpenUserClassesRoot를 사용할 필요가 없습니다. 이러한 애플리케이션은 RegOpenKeyEx 함수를 호출하여 대화형 사용자에 대한 HKEY_CLASSES_ROOT 키의 병합된 보기를 검색할 수 있습니다.

요구 사항


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