PROFILEINFOW 结构 (profinfo.h)

  • 项目

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

语法

typedef struct _PROFILEINFOW {
  DWORD              dwSize;
  DWORD              dwFlags;
  MIDL_STRING LPWSTR lpUserName;
  MIDL_STRING LPWSTR lpProfilePath;
  MIDL_STRING LPWSTR lpDefaultPath;
  MIDL_STRING LPWSTR lpServerName;
  MIDL_STRING LPWSTR lpPolicyPath;
#if ...
  ULONG_PTR          hProfile;
#else
  HANDLE             hProfile;
#endif
} PROFILEINFOW, *LPPROFILEINFOW;

成员

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

类型： 句柄

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

用户配置文件概述