Структура 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 как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
заголовка	profinfo.h (include Userenv.h)

См. также

LoadUserProfile

ВыгрузкаUserProfile

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