UnloadUserProfile 함수(userenv.h)

  • 아티클

LoadUserProfile 함수에 의해 로드된 사용자의 프로필을 언로드합니다. 호출자는 컴퓨터에 대한 관리 권한이 있어야 합니다. 자세한 내용은 LoadUserProfile 함수의 주의 섹션을 참조하세요.

구문

USERENVAPI BOOL UnloadUserProfile(
  [in] HANDLE hToken,
  [in] HANDLE hProfile
);

매개 변수

[in] hToken

형식: HANDLE

LogonUser, CreateRestrictedToken, DuplicateToken, OpenProcessToken 또는 OpenThreadToken 함수에서 반환된 사용자의 토큰입니다. 토큰에는 TOKEN_IMPERSONATE 및 TOKEN_DUPLICATE 액세스 권한이 있어야 합니다. 자세한 내용은 Access-Token 개체에 대한 액세스 권한을 참조하세요.

[in] hProfile

형식: HANDLE

레지스트리 키에 대한 핸들입니다. 이 값은 PROFILEINFO 구조체의 hProfile 멤버입니다. 자세한 내용은 LoadUserProfile 및 레지스트리 키 보안 및 액세스 권한의 설명 섹션을 참조하세요.

반환 값

형식: BOOL

성공하면 TRUE이고, 그렇지 않으면 FALSE입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

UnloadUserProfile을 호출하기 전에 사용자의 레지스트리 하이브에서 연 키에 대한 모든 핸들이 닫혀 있는지 확인해야 합니다. 열려 있는 레지스트리 핸들을 모두 닫지 않으면 사용자의 프로필이 언로드되지 않습니다. 자세한 내용은 레지스트리 키 보안 및 액세스 권한 및레지스트리 하이브를 참조하세요.

관리자 권한이 필요한 함수를 호출하는 방법에 대한 자세한 내용은 특수 권한으로 실행을 참조하세요.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버 Windows 2000 Server[데스크톱 앱만]
대상 플랫폼 Windows
헤더 userenv.h
라이브러리 Userenv.lib
DLL Userenv.dll

추가 정보

LoadUserProfile

PROFILEINFO

사용자 프로필 개요

사용자 프로필 참조