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

Статья
08/22/2023

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

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

Расширение кодируется как пара "имя-значение", где имя равно строке Юникода "CertificateTemplate", а связанное значение — это имя шаблона. В следующем синтаксисе показан пример выходных данных абстрактного синтаксического нотации 1 (ASN.1) для шаблона с именем User. Значение расширения кодируется с помощью Distinguished Encoding Rules (DER).


30 42				; SEQUENCE (42 Bytes)
|  06 0a				; OBJECT_ID (a Bytes)
|  |  2b 06 01 04 01 82 37 0d  02 01
|  |     ; 1.3.6.1.4.1.311.13.2.1 Enrollment Name Value Pair
|  31 34				; SET (34 Bytes)
|     30 32			; SEQUENCE (32 Bytes)
|        1e 26			; UNICODE_STRING (26 Bytes)
|        |  00 43 00 65 00 72 00 74  00 69 00 66 00 69 00 63  ; .C.e.r.t.i.f.i.c
|        |  00 61 00 74 00 65 00 54  00 65 00 6d 00 70 00 6c  ; .a.t.e.T.e.m.p.l
|        |  00 61 00 74 00 65                                 ; .a.t.e
|        |     ; "CertificateTemplate"
|        1e 08			; UNICODE_STRING (8 Bytes)
|           00 55 00 73 00 65 00 72                           ; .U.s.e.r
|              ; "User"

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

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

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

Методы

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


IX509ExtensionTemplateName::get_TemplateName Извлекает имя шаблона.
IX509ExtensionTemplateName::InitializeDecode Инициализирует расширение из массива байтов в кодировке Distinguished Encoding Rules (DER), содержащего значение расширения. (IX509ExtensionTemplateName.InitializeDecode)
IX509ExtensionTemplateName::InitializeEncode Инициализирует расширение из строки, содержащей имя шаблона.

Требования

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

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

Интерфейсы CertEnroll

IX509Extension