UnloadUserProfile 函数 (userenv.h)

卸载由 LoadUserProfile 函数加载的用户配置文件。 调用方必须在计算机上具有管理权限。 有关详细信息,请参阅 LoadUserProfile 函数的“备注”部分。

语法

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

参数

[in] hToken

类型: HANDLE

用户的令牌,从 LogonUserCreateRestrictedTokenDuplicateTokenOpenProcessTokenOpenThreadToken 函数返回。 令牌必须具有 TOKEN_IMPERSONATETOKEN_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

另请参阅

LoadUserProfile

PROFILEINFO

用户配置文件概述

用户配置文件参考