Интерфейс ICertSrvSetup (casetup.h)

Статья
08/22/2023

Интерфейс ICertSrvSetup определяет функции для установки и удаления ролей центра сертификации (ЦС) и веб-регистрации центра сертификации на компьютере служб сертификации .

Корпорация Майкрософт предоставляет реализацию этого интерфейса в классе CCertSrvSetup . Для установки необходимо вызвать метод InitializeDefaults перед доступом к каким-либо свойствам или вызову любых других методов в объекте CCertSrvSetup .

В C++ экземпляр этого интерфейса создается путем вызова функции CoCreateInstance с идентификатором класса CLSID_CCertSrvSetup .

Windows Server 2008 Standard: Следующие службы недоступны:

Служба оперативного реагирования
Служба подачи заявок на сетевые устройства

Кроме того, служба центра сертификации (ЦС) имеет ограниченные функциональные возможности:

Шаблоны версии 2 не поддерживаются; Поэтому автоматическая регистрация не поддерживается.
Делегированные агенты регистрации не поддерживаются.
Разделение ролей не поддерживается.

Наследование

Интерфейс ICertSrvSetup наследуется от интерфейса IDispatch . ICertSrvSetup также имеет следующие типы членов:

Методы

Интерфейс ICertSrvSetup содержит следующие методы.


ICertSrvSetup::CAImportPFX Импортирует сертификат центра сертификации (ЦС) и связанный с ним закрытый ключ в хранилище локального компьютера.
ICertSrvSetup::get_CAErrorId Возвращает идентификатор для дополнительных сведений об ошибке, связанных со спецификацией центра сертификации (ЦС).
ICertSrvSetup::get_CAErrorString Возвращает строковые данные для получения дополнительных сведений об ошибке, связанных со спецификацией центра сертификации (ЦС).
ICertSrvSetup::GetCASetupProperty Возвращает значение свойства для конфигурации центра сертификации (ЦС).
ICertSrvSetup::GetExistingCACertificates Возвращает коллекцию объектов CertSrvSetupKeyInformation, представляющих действительные сертификаты центра сертификации (ЦС), установленные на компьютере.
ICertSrvSetup::GetHashAlgorithmList Возвращает список хэш-алгоритмов, поддерживаемых указанным поставщиком служб шифрования (CSP) для алгоритма асимметричного ключа подписи.
ICertSrvSetup::GetKeyLengthList Возвращает список длин ключей, поддерживаемых указанным поставщиком служб шифрования (CSP). (ICertSrvSetup.GetKeyLengthList)
ICertSrvSetup::GetPrivateKeyContainerList Возвращает список имен контейнеров ключей, хранящихся указанным поставщиком служб шифрования (CSP) для алгоритмов асимметричного ключа подписи.
ICertSrvSetup::GetProviderNameList Возвращает список поставщиков служб шифрования (CSP), которые предоставляют алгоритмы подписи асимметричных ключей на компьютере.
ICertSrvSetup::GetSupportedCATypes Возвращает типы центров сертификации (ЦС), которые можно установить на компьютере в контексте вызывающего объекта.
ICertSrvSetup::InitializeDefaults Инициализирует объект CCertSrvSetup со значениями по умолчанию, чтобы включить установку роли центра сертификации.
ICertSrvSetup::Install Устанавливает роль, настроенную в объекте CCertSrvSetup.
ICertSrvSetup::IsPropertyEditable Указывает вызывающей стороны, можно ли изменить указанное свойство.
ICertSrvSetup::P ostUnInstall Не реализовано и зарезервировано для использования в будущем.
ICertSrvSetup::P reUnInstall Временно сохраняет сведения о состоянии конкретной роли, а затем удаляет роль.
ICertSrvSetup::SetCADistinguishedName Задает общее имя центра сертификации (ЦС) и необязательный суффикс различающегося имени.
ICertSrvSetup::SetCASetupProperty Задает значение свойства для конфигурации центра сертификации (ЦС).
ICertSrvSetup::SetDatabaseInformation Задает сведения, связанные с базой данных, для роли центра сертификации (ЦС).
ICertSrvSetup::SetParentCAInformation Задает сведения о родительском центре сертификации (ЦС) для конфигурации подчиненного ЦС.
ICertSrvSetup::SetWebCAInformation Задает сведения о центре сертификации (ЦС) для роли веб-регистрации центра сертификации.

Требования

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

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

IDispatch

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