通过

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，则使用本地计算机名称。

Note As of Windows Vista， this parameter must be NULL. 如果不是，此函数将失败，错误代码ERROR_INVALID_PARAMETER。
 

返回值

类型：BOOL

如果成功，则 TRUE;否则，FALSE。 若要获取扩展的错误信息，请调用 GetLastError。

言论

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

注意

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

要求

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

另请参阅

用户配置文件概述

用户配置文件参考