Интерфейс IX509ExtensionTemplate (certenroll.h)

  • Статья

Интерфейс IX509ExtensionTemplate определяет методы и свойства, которые можно использовать для инициализации или извлечения расширения CertificateTemplate . Это расширение можно поместить в запрос на сертификат , чтобы сообщить центру сертификации , какой шаблон следует использовать при выдаче или продлении сертификата.

Примечание Расширение CertificateTemplate используется для идентификации шаблонов версии 2. Чтобы определить шаблон версии 1, можно использовать расширение CertificateTemplateName , определенное интерфейсом IX509ExtensionTemplateName .

 
В следующем синтаксисе показана структура абстрактного синтаксиса нотации 1 (ASN.1) расширения. Значение расширения кодируется с помощью Distinguished Encoding Rules (DER) и включается в запрос сертификата. 

----------------------------------------------------------------------
-- CertificateTemplate
-- XCN_OID_CERTIFICATE_TEMPLATE (1.3.6.1.4.1.311.21.7)
----------------------------------------------------------------------

CertificateTemplate ::= SEQUENCE 
{
   templateID              EncodedObjectID,
   templateMajorVersion    TemplateVersion,
   templateMinorVersion    TemplateVersion OPTIONAL
}

TemplateVersion ::= INTEGER (0..4294967295)

Чтобы добавить этот объект расширения в запрос PKCS #10 или запрос CMC, необходимо сначала добавить его в коллекцию IX509Extensions и использовать коллекцию для инициализации объекта IX509AttributeExtensions . Дополнительные сведения см. в разделах Расширения PKCS #10 и Расширения CMC .

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

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

Методы

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

 
IX509ExtensionTemplate::get_MajorVersion

Извлекает минимальный основной номер версии шаблона сертификата.
IX509ExtensionTemplate::get_MinorVersion

Извлекает минимальный дополнительный номер версии шаблона сертификата.
IX509ExtensionTemplate::get_TemplateOid

Извлекает идентификатор объекта шаблона (OID).
IX509ExtensionTemplate::InitializeDecode

Инициализирует расширение из массива байтов в кодировке DER, содержащего значение расширения.
IX509ExtensionTemplate::InitializeEncode

Инициализирует расширение из идентификатора объекта шаблона (OID), а также из основного и дополнительного номеров версий.

Требования

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

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

Интерфейсы CertEnroll

IX509Extension