Интерфейс ICertServerPolicy (certif.h)
Интерфейс 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) |