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 |