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

Статья
08/22/2023

Коллекция интерфейсов IAlternativeName используется объектом IX509ExtensionAlternativeNames для представления экземпляра расширения AlternativeNames . Коллекция представлена интерфейсом IAlternativeNames . В следующем синтаксисе показана структура абстрактного синтаксиса нотации 1 (ASN.1) расширения.


----------------------------------------------------------------------
-- AlternativeNames 
-- XCN_OID_SUBJECT_ALT_NAME2 (2.5.29.17)
----------------------------------------------------------------------

AltNames ::= SEQUENCE --#public-- OF GeneralName
GeneralNames ::= AltNames

GeneralName ::= CHOICE 
{
  otherName              [0] IMPLICIT OtherName,
  rfc822Name             [1] IMPLICIT IA5STRING,
  dNSName                [2] IMPLICIT IA5STRING,
  x400Address            [3] IMPLICIT SeqOfAny,       --Not supported
  directoryName          [4] EXPLICIT ANY,    
  ediPartyName           [5] IMPLICIT SeqOfAny,
  uniformResourceLocator [6] IMPLICIT IA5STRING,
  iPAddress              [7] IMPLICIT OCTETSTRING,
  registeredID           [8] IMPLICIT EncodedObjectID --Not supported
}

OtherName ::= SEQUENCE 
{
   type                    EncodedObjectID,
   value                   [0] EXPLICIT NOCOPYANY 
}

Объект IAlternativeName можно инициализировать из перечисления AlternativeNameType . Доступны следующие типы, но они поддерживаются различными методами инициализации, как указано.

Значение	Описание	Метод инициализации
XCN_CERT_ALT_NAME_OTHER_NAME	Имя состоит из идентификатора объекта (OID) и массива байтов.	InitializeFromOtherName
XCN_CERT_ALT_NAME_RFC822_NAME	Имя — это адрес электронной почты.	InitializeFromString
XCN_CERT_ALT_NAME_DNS_NAME	Это dns-имя.	InitializeFromString
XCN_CERT_ALT_NAME_DIRECTORY_NAME	Это имя каталога X.500 .	InitializeFromRawData
XCN_CERT_ALT_NAME_URL	Имя является URL-адресом.	InitializeFromString
XCN_CERT_ALT_NAME_IP_ADDRESS	Имя является IP-адресом.	InitializeFromRawData
XCN_CERT_ALT_NAME_REGISTERED_ID	Имя является зарегистрированным идентификатором OID.	InitializeFromString
XCN_CERT_ALT_NAME_GUID	Имя — guid.	InitializeFromRawData
XCN_CERT_ALT_NAME_USER_PRINCIPLE_NAME	Это имя субъекта-пользователя (UPN).	InitializeFromString

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

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

Методы

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


IAlternativeName::get_ObjectId Извлекает идентификатор объекта (OID), если он есть, связанный с именем .
IAlternativeName::get_RawData Извлекает массив байтов в кодировке Distinguished Encoding Rules (DER), содержащий имя.
IAlternativeName::get_StrValue Извлекает строку, содержащую адрес электронной почты, dns-имя, URL-адрес, идентификатор зарегистрированного объекта (OID) или имя участника-пользователя (UPN).
IAlternativeName::get_Type Извлекает альтернативный тип имени.
IAlternativeName::InitializeFromOtherName Инициализирует объект из идентификатора объекта (OID) и связанных необработанных данных (массив байтов).
IAlternativeName::InitializeFromRawData Инициализирует объект из GUID алгоритма цифровой подписи (DSA), имени каталога X.500 или IP-адреса, содержащегося в массиве байтов в Distinguished Encoding Rules (DER).
IAlternativeName::InitializeFromString Инициализирует объект из строки, содержащей адрес электронной почты, dns-имя, URL-адрес, идентификатор зарегистрированного объекта (OID) или имя участника-пользователя (UPN).

Требования

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

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

Интерфейсы CertEnroll

IAlternativeNames

IDispatch

IX509ExtensionAlternativeNames

Поделиться через