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


Метод ICertificateEnrollmentServerSetup::InitializeInstallDefaults (casetup.h)

Метод InitializeInstallDefaults инициализирует объект ICertificateEnrollmentServerSetup с конфигурацией по умолчанию.

Синтаксис

HRESULT InitializeInstallDefaults();

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

Код возврата Описание
E_ACCESSDENIED
Пользователь должен быть администратором корневого каталога домена или предприятия. Компьютер должен быть присоединен к домену.

Если пользователь не является корневым администратором домена или администратором предприятия, свойству ErrorString присваивается следующее значение:

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

Если компьютер не присоединен к домену, свойству ErrorString присваивается следующее значение:

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

HRESULT_FROM_WIN32(ERROR_INVALID_STATE)
Объект ICertificateEnrollmentServerSetup уже инициализирован. Свойству ErrorString присвоено следующее значение:

"Объект установки уже инициализирован. Этот объект не может быть инициализирован более одного раза.

Комментарии

Этот метод выполняет следующие действия:

  • Определяет, был ли объект ICertificateEnrollmentServerSetup уже инициализирован.
    Примечание Если эта проверка завершается сбоем, метод задает для свойства ErrorString значение "Объект установки уже инициализирован. Этот объект не может быть инициализирован более одного раза.
     
  • Определяет, является ли пользователь администратором корневого каталога домена или предприятия.
    Примечание Если эта проверка завершается сбоем, метод задает свойству ErrorString значение "Для запуска программы установки необходимо быть членом группы администраторов предприятия".
     
  • Определяет, присоединен ли компьютер к домену.
    Примечание Если эта проверка завершается сбоем, метод задает для свойства ErrorString значение "Веб-служба регистрации сертификатов или веб-служба политики регистрации сертификатов не может быть установлена на компьютере, который не является членом домена".
     
  • Задает процедуру проверки подлинности по умолчанию Kerberos. Чтобы изменить метод проверки подлинности, можно вызвать SetProperty .
  • Определяет, установлена ли CES на компьютере под управлением Windows Server 2008 R2.
    Примечание Если это проверка завершается сбоем, метод задает для свойства ErrorString значение "Веб-служба регистрации сертификатов или веб-служба политики регистрации сертификатов должна быть установлена на рядовом сервере в лесу Active Directory, в котором успешно запущена версия ADPrep /forestprep для Windows Server 2008 R2".
     
  • Задает контекст сервера по умолчанию для встроенной учетной записи ApplicationPoolIdentity .
  • Задает для свойства ENUM_CESSETUPPROP_RENEWALONLY значение FALSE.
  • Задает для свойства ENUM_CESSETUPPROP_URL значение "https:// computerDNSname/SanitizedCAShortName_CES_Kerberos/service.svc/ces", если существует допустимая конфигурация центра сертификации. Если допустимая конфигурация не существует, свойство ENUM_CESSETUPPROP_URL не задано. SanitizedCAShortName — это санизированное короткое имя ЦС. Дополнительные сведения о дезинфицируемых именах см. в разделе GetConfig.
    Примечание Если центр сертификации является автономным ЦС, свойству ErrorString присваивается значение "Веб-службу регистрации сертификатов нельзя использовать с автономным центром сертификации (ЦС). Его можно использовать только с корпоративным ЦС".
     
Перед вызовом любого метода, отличного от UnInstall, необходимо вызвать метод InitializeInstallDefaults. Вызовите метод Install , чтобы установить настроенную службу. Вызовите UnInstall для нового объекта ICertificateEnrollmentServerSetup , чтобы удалить службу.

Требования

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

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

CESSetupProperty

ICertificateEnrollmentServerSetup