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

Удаляет указанный профиль для каждого пользователя и каждого приложения.

Примечание Удаление несуществующего профиля возвращает успех.

 

Синтаксис

USERENVAPI HRESULT DeleteAppContainerProfile(
  [in] PCWSTR pszAppContainerName
);

Параметры

[in] pszAppContainerName

Имя, данное профилю при вызове функции CreateAppContainerProfile . Длина этой строки не более 64 символов соответствует шаблону, описанному регулярным выражением "[-_. A-Za-z0-9]+".

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

Если эта функция выполняется успешно, она возвращает стандартный код HRESULT, включая следующее:

Код возврата	Описание
HRESULT_FROM_WIN32(ERROR_NOT_SUPPORTED)	Если метод вызывается из контейнера приложения.
S_OK	Профиль успешно удален.
E_INVALIDARG	Если имя контейнера имеет значение NULL или превышено заданное ограничение длины.

Комментарии

Чтобы обеспечить наилучшие результаты, закройте все дескрипторы файлов в расположениях хранилища профилей перед вызовом функции DeleteAppContainerProfile . В противном случае эта функция может не полностью удалить расположения хранилища для профиля.

Эта функция удаляет профиль текущего пользователя. Чтобы удалить профиль для другого пользователя, необходимо олицетворить этого пользователя.

Если функция завершается сбоем, состояние профиля не определено, и для завершения операции необходимо снова вызвать Метод DeleteAppContainerProfile .

Требования

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

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

CreateAppContainerProfile