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 |