Interfaccia IX509ExtensionAlternativeNames (certenroll.h)
L'interfaccia IX509ExtensionAlternativeNames consente di specificare uno o più moduli di nome alternativi per l'oggetto di un certificato. Un'autorità di certificazione elabora l'estensione associando i nomi alla chiave pubblica certificata. La sintassi seguente mostra la struttura ASN.1 ( Abstract Syntax Notation One ) dell'estensione. Il valore dell'estensione viene codificato usando Distinguished Encoding Rules (DER) e incluso nella richiesta di certificato.
----------------------------------------------------------------------
-- 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
}
Se si inizializza questa estensione usando un insieme IAlternativeNames , sono supportati i tipi di nome seguenti.
| Valore | Descrizione |
|---|---|
| XCN_CERT_ALT_NAME_OTHER_NAME | Il nome è costituito da un identificatore di oggetto e da una matrice di byte che contiene il nome. |
| XCN_CERT_ALT_NAME_RFC822_NAME | Il nome è un indirizzo di posta elettronica. |
| XCN_CERT_ALT_NAME_DNS_NAME | Il nome è un nome di sistema del nome di dominio. |
| XCN_CERT_ALT_NAME_DIRECTORY_NAME | Il nome è un nome di directory X.500 . |
| XCN_CERT_ALT_NAME_URL | Il nome è un URL. |
| XCN_CERT_ALT_NAME_IP_ADDRESS | Il nome è un indirizzo IP (Internet Protocol). |
| XCN_CERT_ALT_NAME_REGISTERED_ID | Il nome è un identificatore di oggetto registrato (OID). |
| XCN_CERT_ALT_NAME_GUID | Il nome è un GUID. Si tratta di una forma di otherName. |
| XCN_CERT_ALT_NAME_USER_PRINCIPLE_NAME | Il nome è un nome dell'entità utente (UPN). Il formato UPN è basato su RFC 822. |
Per aggiungere questo oggetto di estensione a una richiesta PKCS #10 o a una richiesta CMC, è innanzitutto necessario aggiungerlo a un insieme IX509Extensions e usare l'insieme per inizializzare un oggetto IX509AttributeExtensions . Per altre informazioni, vedere gli argomenti PKCS #10 Extensions (Estensioni PKCS #10 ) e CMC Extensions (Estensioni CMC ).
Ereditarietà
L'interfaccia IX509ExtensionAlternativeNames eredita da IX509Extension. IX509ExtensionAlternativeNames include anche questi tipi di membri:
Metodi
L'interfaccia IX509ExtensionAlternativeNames include questi metodi.
| IX509ExtensionAlternativeNames::get_AlternativeNames Recupera una raccolta di nomi alternativi del soggetto. |
| IX509ExtensionAlternativeNames::InitializeDecode Inizializza l'estensione da una matrice di byte codificata Distinguished Encoding Rules (DER) che contiene il valore dell'estensione. (IX509ExtensionAlternativeNames.InitializeDecode) |
| IX509ExtensionAlternativeNames::InitializeEncode Inizializza l'estensione da un insieme IAlternativeNames. |
Requisiti
| Client minimo supportato | Windows Vista [solo app desktop] |
| Server minimo supportato | Windows Server 2008 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | certenroll.h |