Структура 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, Безопасность раздела реестра и права доступа и Кусты реестра.

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

Примечание

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

Требования

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

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

LoadUserProfile

UnloadUserProfile

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