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
Library	Userenv.lib
DLL	Userenv.dll