Структура 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 этой структуры.

Требования

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

LoadUserProfile

UnloadUserProfile

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