Interface IX509ExtensionAlternativeNames (certenroll.h)
L’interface IX509ExtensionAlternativeNames vous permet de spécifier un ou plusieurs formulaires de nom alternatifs pour l’objet d’un certificat. Une autorité de certification traite l’extension en liant les noms à la clé publique certifiée. La syntaxe suivante montre la structure ASN.1 ( Abstract Syntax Notation One ) de l’extension. La valeur d’extension est encodée à l’aide de Distinguished Encoding Rules (DER) et incluse dans la demande de certificat.
----------------------------------------------------------------------
-- 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
}
Si vous initialisez cette extension à l’aide d’une collection IAlternativeNames , les types de noms suivants sont pris en charge.
| Valeur | Description |
|---|---|
| XCN_CERT_ALT_NAME_OTHER_NAME | Le nom se compose d’un identificateur d’objet et d’un tableau d’octets qui contient le nom. |
| XCN_CERT_ALT_NAME_RFC822_NAME | Le nom est une adresse e-mail. |
| XCN_CERT_ALT_NAME_DNS_NAME | Le nom est un nom de système de noms de domaine. |
| XCN_CERT_ALT_NAME_DIRECTORY_NAME | Le nom est un nom de répertoire X.500 . |
| XCN_CERT_ALT_NAME_URL | Le nom est une URL. |
| XCN_CERT_ALT_NAME_IP_ADDRESS | Le nom est une adresse IP (Internet Protocol). |
| XCN_CERT_ALT_NAME_REGISTERED_ID | Le nom est un identificateur d’objet inscrit (OID). |
| XCN_CERT_ALT_NAME_GUID | Le nom est un GUID. Il s’agit d’une forme de otherName. |
| XCN_CERT_ALT_NAME_USER_PRINCIPLE_NAME | Le nom est un nom d’utilisateur principal (UPN). Le format UPN est basé sur RFC 822. |
Pour ajouter cet objet d’extension à une requête PKCS #10 ou CMC, vous devez d’abord l’ajouter à une collection IX509Extensions et utiliser la collection pour initialiser un objet IX509AttributeExtensions . Pour plus d’informations, consultez les rubriques Extensions PKCS #10 et Extensions CMC .
Héritage
L’interface IX509ExtensionAlternativeNames hérite de IX509Extension. IX509ExtensionAlternativeNames a également les types de membres suivants :
Méthodes
L’interface IX509ExtensionAlternativeNames a ces méthodes.
| IX509ExtensionAlternativeNames::get_AlternativeNames Récupère une collection d’autres noms de sujet. |
| IX509ExtensionAlternativeNames::InitializeDecode Initialise l’extension à partir d’un tableau d’octets encodé Distinguished Encoding Rules (DER) qui contient la valeur d’extension. (IX509ExtensionAlternativeNames.InitializeDecode) |
| IX509ExtensionAlternativeNames::InitializeEncode Initialise l’extension à partir d’une collection IAlternativeNames. |
Configuration requise
| 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 |