Метод ICertificateEnrollmentPolicyServerSetup::UnInstall (casetup.h)

Статья
08/22/2023

Метод UnInstall удаляет веб-службу политики регистрации сертификатов (CEP).

Синтаксис

HRESULT UnInstall(
  [in, optional] VARIANT *pAuthKeyBasedRenewal
);

Параметры

[in, optional] pAuthKeyBasedRenewal

Указатель на массив VARIANT , содержащий тип проверки подлинности и необязательные значения KeyBasedRenewal.

В первом элементе массива можно задать следующие значения для типа проверки подлинности.

X509AuthKerberos
X509AuthUserName
X509AuthCertificate

Второй (необязательный) элемент в значении массива является VARIANT_TRUE для CEP KeyBasedRenewal.

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

Код возврата	Описание
E_ACCESSDENIED	Пользователь должен быть локальным администратором. Для свойства ErrorString задано значение "Для запуска этой установки необходимо быть администратором локального компьютера".
HRESULT_FROM_WIN32(ERROR_INVALID_STATE)	Объект ICertificateEnrollmentPolicyServerSetup инициализирован. Объект инициализируется при успешном вызове InitializeInstallDefaults. Свойство ErrorString имеет значение "Объект был инициализирован. Вы не можете вызвать UnInstall для инициализированного объекта".

Код возврата

Описание

E_ACCESSDENIED

Пользователь должен быть локальным администратором.

Для свойства ErrorString задано значение "Для запуска этой установки необходимо быть администратором локального компьютера".

HRESULT_FROM_WIN32(ERROR_INVALID_STATE)

Объект ICertificateEnrollmentPolicyServerSetup инициализирован. Объект инициализируется при успешном вызове InitializeInstallDefaults.

Свойство ErrorString имеет значение "Объект был инициализирован. Вы не можете вызвать UnInstall для инициализированного объекта".

Этот метод можно вызвать для удаления службы CEP. Однако, поскольку метод UnInstall нельзя вызвать для объекта ICertificateEnrollmentPolicyServerSetup , который уже был инициализирован, необходимо создать новый ICertificateEnrollmentPolicyServerSetup перед вызовом UnInstall.

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

Инициализирует инструментарий управления Windows (WMI).
Пытается удалить каталог %Windir%\Systemdata\Cep и все подкаталоги приложений, которые могут существовать. Дополнительные сведения см. в разделе Установка примечаний.
Пытается удалить пул приложений и все приложения в пуле.
Пытается обновить дескриптор безопасности контейнера Удаленные объекты в Active Directory, чтобы запретить доступ компьютеру. Дополнительные сведения см. в разделе Установка примечаний.

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

Требования

Требование	Значение
Минимальная версия клиента	Windows 7 [только классические приложения]
Минимальная версия сервера	Windows Server 2008 R2 [только классические приложения]
Целевая платформа	Windows
Header	casetup.h
DLL	Certocm.dll

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

ICertificateEnrollmentPolicyServerSetup

InitializeInstallDefaults

Установка

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