Поделиться через


Функция UnloadUserProfile (userenv.h)

Выгружает профиль пользователя, загруженный функцией LoadUserProfile . Вызывающий объект должен иметь права администратора на компьютере. Дополнительные сведения см. в разделе Примечания функции LoadUserProfile .

Синтаксис

USERENVAPI BOOL UnloadUserProfile(
  [in] HANDLE hToken,
  [in] HANDLE hProfile
);

Параметры

[in] hToken

Тип: HANDLE

Маркер для пользователя, возвращенный функцией LogonUser, CreateRestrictedToken, DuplicateToken, OpenProcessToken или OpenThreadToken . Маркер должен иметь доступ к TOKEN_IMPERSONATE и TOKEN_DUPLICATE . Дополнительные сведения см. в разделе Права доступа к объектам Access-Token.

[in] hProfile

Тип: HANDLE

Дескриптор раздела реестра. Это значение является элементом hProfile структуры PROFILEINFO . Дополнительные сведения см. в разделе Примечания статьи LoadUserProfile и безопасность раздела реестра и права доступа.

Возвращаемое значение

Тип: BOOL

Значение TRUE в случае успешного выполнения; в противном случае — FALSE. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Комментарии

Перед вызовом UnloadUserProfile необходимо убедиться, что все дескрипторы ключей, открытых в кусте реестра пользователя, закрыты. Если не закрыть все открытые дескрипторы реестра, профиль пользователя выгрузить не удастся. Дополнительные сведения см. в разделах Безопасность раздела реестра и права доступа и Кусты реестра.

Дополнительные сведения о вызове функций, которым требуются права администратора, см. в разделе Запуск с особыми привилегиями.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header userenv.h
Библиотека Userenv.lib
DLL Userenv.dll

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

LoadUserProfile

PROFILEINFO

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

Справочник по профилям пользователей