GetDefaultUserProfileDirectoryW 函数 (userenv.h)

  • 项目

检索默认用户配置文件的根路径。

语法

USERENVAPI BOOL GetDefaultUserProfileDirectoryW(
  [out, optional] LPWSTR  lpProfileDir,
  [in, out]       LPDWORD lpcchSize
);

参数

[out, optional] lpProfileDir

类型： LPTSTR

指向缓冲区的指针，当此函数成功返回时，该缓冲区接收默认用户的配置文件目录的路径。 将此值设置为 NULL 以确定所需的缓冲区大小。

[in, out] lpcchSize

类型： LPDWORD

指定 lpProfileDir 缓冲区的大小（以 TCHAR 为单位）。

如果 lpProfileDir 指定的缓冲区不够大或 lpProfileDir 为 NULL，则函数将失败，并且此参数将接收必要的缓冲区大小，包括终止 null 字符。

返回值

类型： BOOL

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

注解

下面是 Windows XP 中 GetDefaultUserProfileDirectory 返回的路径示例：

C:\Documents and Settings\Default User

下面是 Windows 7 中 GetDefaultUserProfileDirectory 返回的路径示例：

C:\Users\Default

若要获取此目录的子目录的路径，请使用 SHGetFolderPath (Windows XP 和早期) 或 SHGetKnownFolderPath (Windows Vista) 函数。

注意

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

要求

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

另请参阅

GetAllUsersProfileDirectory

GetProfilesDirectory

GetUserProfileDirectory

用户配置文件概述

用户配置文件参考