Структура 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

Тип: HANDLE

Дескриптор для поддеревья реестра HKEY_CURRENT_USER . Дополнительные сведения см. в подразделе "Примечания".

Комментарии

Не используйте переменные среды при указании пути. Функция LoadUserProfile не развертывает переменные среды, такие как %username%, в пути.

При успешном выполнении вызова LoadUserProfile член hProfile получает дескриптор раздела реестра, открытый в корне поддеревья пользователя и открытый с полным доступом (KEY_ALL_ACCESS). Дополнительные сведения см. в разделах Примечания в разделах LoadUserProfile, Безопасность раздела реестра и права доступа и Кусты реестра.

Службы и приложения, вызывающие LoadUserProfile, должны проверка, чтобы узнать, есть ли у пользователя перемещаемый профиль. Если у пользователя есть перемещаемый профиль, укажите его путь в качестве элемента lpProfilePath этой структуры.

Примечание

Заголовок profinfo.h определяет PROFILEINFO как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора UNICODE. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Верхняя часть profinfo.h (включая Userenv.h)

См. также раздел

LoadUserProfile

UnloadUserProfile

Обзор профилей пользователей