Interface IAlternativeName (certenroll.h)

Une collection d’interfaces IAlternativeName est utilisée par un objet IX509ExtensionAlternativeNames pour représenter un instance d’une extension AlternativeNames. La collection est représentée par l’interface IAlternativeNames . La syntaxe suivante montre la structure ASN.1 ( Abstract Syntax Notation One ) de l’extension.

----------------------------------------------------------------------
-- 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 
}

Vous pouvez initialiser un objet IAlternativeName à partir d’une énumération AlternativeNameType . Les types suivants sont disponibles, mais ils sont pris en charge par différentes méthodes d’initialisation, comme indiqué.

Valeur	Description	Méthode d’initialisation
XCN_CERT_ALT_NAME_OTHER_NAME	Le nom se compose d’un identificateur d’objet (OID) et d’un tableau d’octets.	InitializeFromOtherName
XCN_CERT_ALT_NAME_RFC822_NAME	Le nom est une adresse e-mail.	InitializeFromString
XCN_CERT_ALT_NAME_DNS_NAME	Le nom est un nom DNS (Domain Name System).	InitializeFromString
XCN_CERT_ALT_NAME_DIRECTORY_NAME	Le nom est un nom de répertoire X.500 .	InitializeFromRawData
XCN_CERT_ALT_NAME_URL	Le nom est une URL.	InitializeFromString
XCN_CERT_ALT_NAME_IP_ADDRESS	Le nom est une adresse IP (Internet Protocol).	InitializeFromRawData
XCN_CERT_ALT_NAME_REGISTERED_ID	Le nom est un OID inscrit.	InitializeFromString
XCN_CERT_ALT_NAME_GUID	Le nom est un GUID.	InitializeFromRawData
XCN_CERT_ALT_NAME_USER_PRINCIPLE_NAME	Le nom est un nom d’utilisateur principal (UPN).	InitializeFromString

Héritage

L’interface IAlternativeName hérite de l’interface IDispatch. IAlternativeName a également les types de membres suivants :

Méthodes

L’interface IAlternativeName a ces méthodes.

IAlternativeName ::get_ObjectId Récupère l’identificateur d’objet (OID), le cas échéant, associé au nom.
IAlternativeName ::get_RawData Récupère le tableau d’octets encodé Distinguished Encoding Rules (DER) qui contient le nom.
IAlternativeName ::get_StrValue Récupère une chaîne qui contient une adresse e-mail, un nom DNS (Domain Name System), une URL, un identificateur d’objet inscrit (OID) ou un nom d’utilisateur principal (UPN).
IAlternativeName ::get_Type Récupère le type de nom de remplacement.
IAlternativeName ::InitializeFromOtherName Initialise l’objet à partir d’un identificateur d’objet (OID) et des données brutes associées (tableau d’octets).
IAlternativeName ::InitializeFromRawData Initialise l’objet à partir d’un GUID DSA (Digital Signature Algorithm), d’un nom de répertoire X.500 ou d’une adresse IP (Internet Protocol) contenue dans un tableau d’octets encodé Distinguished Encoding Rules (DER).
IAlternativeName ::InitializeFromString Initialise l’objet à partir d’une chaîne qui contient une adresse e-mail, un nom DNS (Domain Name System), une URL, un identificateur d’objet inscrit (OID) ou un nom d’utilisateur principal (UPN).

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	certenroll.h

Voir aussi

CertEnroll Interfaces

IAlternativeNames

IDispatch

IX509ExtensionAlternativeNames