Интерфейс ICertServerPolicy (certif.h)

Интерфейс ICertServerPolicy позволяет модулю политики взаимодействовать со службами сертификатов.

Примечание Службы сертификатов взаимодействуют с модулем политики через интерфейс ICertPolicy2 .

 

Интерфейс ICertServerPolicy экспортируется подсистемой сервера и вызывается модулем политики для выполнения следующих задач:

• Укажите, какой запрос сертификата используется в качестве текущего контекста для последующих операций.
• Перечисление и получение расширений (включая флаги расширения) запроса на сертификат, а также установка расширений выданного сертификата.
• Перечисление и получение атрибутов запроса.
• Получение свойств запроса сертификата.
• Получение и задание свойств сертификата.

С момента вызова метода ICertPolicy::VerifyRequest до его возврата доступ к неразрешенным запросам и сертификату можно получить через объект данных Context. Так как модуль политики может добавлять или переопределять свойства запроса путем вызова метода ICertServerPolicy::SetCertificateProperty, свойства сертификата могут отличаться от свойств запроса.

ICertServerPolicy определяется в Certif.h. Однако при создании программы используйте Certsrv.h в качестве включаемого файла. Certcli.dll предоставляет интерфейс ICertServerPolicy . Сведения о типе этого интерфейса также содержатся в Certclil.dll, который поставляется вместе с пакетом средств разработки платформенного программного обеспечения (SDK).

Интерфейсы служб сертификатов поддерживают как модели потоков с подразделениями, так и с бесплатными потоками. Для повышения пропускной способности рекомендуется использовать свободные потоки.

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

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

Методы

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

ICertServerPolicy::EnumerateAttributes Извлекает имя текущего атрибута и перемещает внутренний указатель перечисления на следующий атрибут.
ICertServerPolicy::EnumerateAttributesClose Освобождает ресурсы, связанные с перечислением атрибутов.
ICertServerPolicy::EnumerateAttributesSetup Инициализирует указатель внутреннего перечисления на первый атрибут запроса, связанный с текущим контекстом. (ICertServerPolicy.EnumerateAttributesSetup)
ICertServerPolicy::EnumerateExtensions Извлекает идентификатор объекта (OID) текущего расширения и перемещает указатель внутреннего перечисления на следующее расширение.
ICertServerPolicy::EnumerateExtensionsClose Освобождает ресурсы, связанные с перечислением расширений.
ICertServerPolicy::EnumerateExtensionsSetup Инициализирует указатель внутреннего перечисления на первое расширение сертификата, связанное с текущим контекстом. (ICertServerPolicy.EnumerateExtensionsSetup)
ICertServerPolicy::GetCertificateExtension Извлекает определенное расширение сертификата.
ICertServerPolicy::GetCertificateExtensionFlags Извлекает флаги, связанные с расширением, полученным при последнем вызове Метода GetCertificateExtension.
ICertServerPolicy::GetCertificateProperty Возвращает именованное свойство из сертификата. (ICertServerPolicy.GetCertificateProperty)
ICertServerPolicy::GetRequestAttribute Возвращает именованный атрибут из запроса.
ICertServerPolicy::GetRequestProperty Извлекает определенное свойство из запроса.
ICertServerPolicy::SetCertificateExtension Добавляет в сертификат новое расширение.
ICertServerPolicy::SetCertificateProperty Установка свойства, связанного с сертификатом.
ICertServerPolicy::SetContext Указывает запрос, используемый в качестве контекста для последующих вызовов служб сертификатов.

Требования

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

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

ICertAdmin::ResubmitRequest

ICertAdmin::SetRequestAttributes

ICertPolicy::VerifyRequest

ICertRequest

ICertRequest::Submit

IDispatch