Функция 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 |