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

Статья
08/22/2023

Интерфейс IX509NameValuePair представляет универсальную пару "имя-значение". Хотя существует несколько общих пар "имя-значение", созданных в процессе запроса сертификата и регистрации, этот объект можно использовать для указания любого имени и значения. Коллекцию IX509NameValuePairs можно получить из объектов IX509Enrollment и IX509CertificateRequestCmc. Коллекции не связаны.

Пары "имя-значение" и объект регистрации:: Перед тем как объект IX509Enrollment отправляет запрос на сертификат в центр сертификации (ЦС), коллекция name-value кодируется как объединенная строка атрибута в формате Name1:Value1\Name2:Value2\. Вы можете получить коллекцию, вызвав свойство NameValuePairs . Объект IX509NameValuePairs можно использовать для добавления пар "имя-значение" в коллекцию.

Пары "имя-значение" и объект запроса CMC:

Объект запроса CMC (IX509CertificateRequestCmc) содержит последовательности структур ASN.1 TaggedAttribute, TaggedRequest и TaggedContentInfo . Дополнительные сведения см. в разделе Атрибуты CMC.

Структура TaggedAttribute может содержать атрибут RegInfo . Этот атрибут состоит из массива байтов, содержащего коллекцию пар "имя-значение". Массив байтов создается следующим образом:

Каждая строка "имя-значение" стандартизована. Например, escape-символы "%5C" заменяются символами обратной косой черты (\\).
Каждая пара "имя-значение" объединяется с помощью знака равенства (=).
Все пары объединяются с помощью амперсанда (&) между каждой парой.
Результат кодируется как строка UTF-8.

В следующем примере показаны выходные данные ASN.1 для сертификата CMC, который содержит атрибут RegInfo , содержащий одну пару "имя-значение"RequesterName=Domain\TargetUser".


...
30 33              ; SEQUENCE (33 Bytes)
   02 01                            ; INTEGER (1 Bytes)
   |  02
   06 08                            ; OBJECT_ID (8 Bytes)
   |  2b 06 01 05 05 07 07 12
   |     ; 1.3.6.1.5.5.7.7.18 Reg Info
   31 24                ; SET (24 Bytes)
      04 22 ; OCTET_STRING (22 Bytes)
      52 65 71 75 65 73 74 65  72 4e 61 6d 65 3d 44 6f  ; RequesterName=Do
      6d 61 69 6e 25 35 43 54  61 72 67 65 74 55 73 65  ; main%5CTargetUse
      72 26                                             ; r&amp; 
...

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

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

Методы

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


IX509NameValuePair::get_Name Извлекает часть имени пары "имя-значение".
IX509NameValuePair::get_Value Извлекает часть значения пары "имя-значение".
IX509NameValuePair::Initialize Инициализирует объект из строк, содержащих имя и связанное значение.

Требования

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

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

Интерфейсы CertEnroll

IDispatch

IX509NameValuePairs

Share via