PROFILEINFOA 结构 （profinfo.h）

包含加载或卸载用户配置文件时使用的信息。

语法

typedef struct _PROFILEINFOA {
  DWORD             dwSize;
  DWORD             dwFlags;
  MIDL_STRING LPSTR lpUserName;
  MIDL_STRING LPSTR lpProfilePath;
  MIDL_STRING LPSTR lpDefaultPath;
  MIDL_STRING LPSTR lpServerName;
  MIDL_STRING LPSTR lpPolicyPath;
#if ...
  ULONG_PTR         hProfile;
#else
  HANDLE            hProfile;
#endif
} PROFILEINFOA, *LPPROFILEINFOA;

成员

dwSize

类型：DWORD

此结构的大小（以字节为单位）。

dwFlags

类型：DWORD

此成员可以是以下标志之一：

PI_NOUI

阻止显示配置文件错误消息。

PI_APPLYPOLICY

不支持。

lpUserName

类型：LPTSTR

指向用户名称的指针。 此成员用作存储新配置文件的目录的基名称。

lpProfilePath

类型：LPTSTR

指向 漫游用户配置文件 路径的指针。 如果用户没有漫游配置文件，则此成员可以 NULL。 若要检索用户的漫游配置文件路径，请调用 NetUserGetInfo 函数，并指定信息级别 3 或 4。 有关详细信息，请参阅“备注”。

lpDefaultPath

类型：LPTSTR

指向默认用户配置文件路径的指针。 此成员可以 NULL。

lpServerName

类型：LPTSTR

指向验证域控制器名称的指针，采用 NetBIOS 格式。

lpPolicyPath

类型：LPTSTR

未使用，设置为 NULL。

hProfile

类型：HANDLE

HKEY_CURRENT_USER 注册表子树的句柄。 有关详细信息，请参阅“备注”。

言论

指定路径时不要使用环境变量。 LoadUserProfile 函数不会在路径中扩展环境变量（如 %username%）。

当 LoadUserProfile 调用成功返回时，hProfile 成员会收到一个注册表项句柄，该句柄已打开给用户的子树的根目录（使用完全访问权限打开）（KEY_ALL_ACCESS）。 有关详细信息，请参阅 LoadUserProfile、注册表项安全和访问权限以及 注册表 Hives中的“备注”部分。

调用 LoadUserProfile 的服务和应用程序应检查用户是否有漫游配置文件。 如果用户具有漫游配置文件，请将其路径指定为此结构的 lpProfilePath 成员。

注意

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

要求

要求	价值
最低支持的客户端	Windows 2000 Professional [仅限桌面应用]
支持的最低服务器	Windows 2000 Server [仅限桌面应用]
标头	profinfo.h （包括 Userenv.h）

另请参阅

LoadUserProfile

UnloadUserProfile

用户配置文件概述