deleteProfileW 函数 (userenv.h)

  • 项目

从指定计算机中删除用户配置文件和所有用户相关的设置。 调用方必须具有管理权限才能删除用户的配置文件。

语法

USERENVAPI BOOL DeleteProfileW(
  [in]           LPCWSTR lpSidString,
  [in, optional] LPCWSTR lpProfilePath,
  [in, optional] LPCWSTR lpComputerName
);

参数

[in] lpSidString

类型： LPCTSTR

指向指定用户 SID 的字符串的指针。

[in, optional] lpProfilePath

类型： LPCTSTR

指向指定配置文件路径的字符串的指针。 如果此参数为 NULL，则该函数将从注册表获取路径。

[in, optional] lpComputerName

类型： LPCTSTR

指向字符串的指针，该字符串指定要从中删除配置文件的计算机的名称。 如果此参数为 NULL，则使用本地计算机名称。

注意 从 Windows Vista 开始，此参数必须为 NULL。 否则，此函数将失败，错误代码ERROR_INVALID_PARAMETER。
 

返回值

类型： BOOL

如果成功，则为 TRUE;否则为 FALSE。 要获得更多的错误信息，请调用 GetLastError。

注解

当传递本地系统帐户的安全标识符 (SID) (S-1-5-18) 时，DeleteProfile 可能会失败。

注意

userenv.h 标头将 DeleteProfile 定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。 有关详细信息，请参阅 函数原型的约定。

要求

要求 值
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 userenv.h
Library Userenv.lib
DLL Userenv.dll

另请参阅

用户配置文件概述

用户配置文件参考