Интерфейс IAlternativeName (certenroll.h)
Коллекция интерфейсов 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 |