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 |