Interfaccia ICertEncodeAltName (certenc.h)

L'interfaccia ICertEncodeAltName fornisce metodi per la gestione dei nomi alternativi usati nelle estensioni del certificato.

È possibile creare un'estensione del certificato usando una matrice di nomi alternativa archiviata in un oggetto COM del gestore estensione . Ogni elemento della matrice è una struttura che contiene una stringa di nome e una scelta di nome.

Questa interfaccia è utile per la codifica e la decodifica szOID_SUBJECT_ALT_NAME2 estensioni "2.5.29.17". il modulo dei criteri di esempio SDK usa questa interfaccia.

ICertEncodeAltName è definito in Certenc.h. Quando si crea il programma, tuttavia, usare Certsrv.h come file di inclusione. Certenc.dll fornisce l'interfaccia ICertEncodeAltName . Le informazioni sul tipo per questa interfaccia sono disponibili anche in Certencl.dll, che viene fornito con Platform Software Development Kit (SDK).

Le interfacce di Servizi certificati supportano sia modelli di threading a apartment che free-threading. Per migliorare la velocità effettiva, è consigliabile eseguire il threading gratuito.

Ereditarietà

L'interfaccia ICertEncodeAltName eredita dall'interfaccia IDispatch . ICertEncodeAltName include anche questi tipi di membri:

Metodi

L'interfaccia ICertEncodeAltName include questi metodi.

ICertEncodeAltName::D ecode Decodifica un'estensione del nome alternativo con codifica ASN.1 (AsN.1) e archivia la matrice risultante di stringhe nell'oggetto CertEncodeAltName.
ICertEncodeAltName::Codifica Restituisce una stringa con codifica ASN.1 della matrice di nomi alternativa archiviata in questo oggetto. I nomi dell'oggetto non vengono codificati.
ICertEncodeAltName::GetName Restituisce il nome specificato dalla matrice di nomi alternativi.
ICertEncodeAltName::GetNameChoice Restituisce la scelta del nome in corrispondenza di un indice specificato di una matrice di nomi alternativi.
ICertEncodeAltName::GetNameCount Restituisce il numero di nomi nella matrice di nomi alternativi.
ICertEncodeAltName::Reset Specifica le dimensioni della matrice di nomi alternativi in questo oggetto. Il valore di tutti gli elementi della matrice è impostato su zero.
ICertEncodeAltName::SetNameEntry Imposta un nome in corrispondenza di un indice specificato della matrice di nomi alternativi.

Requisiti

Requisito	Valore
Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	certenc.h (include Certsrv.h)