ICertEncodeAltName-Schnittstelle (certenc.h)

Die ICertEncodeAltName-Schnittstelle stellt Methoden zum Behandeln alternativer Namen bereit, die in Zertifikaterweiterungen verwendet werden.

Eine Zertifikaterweiterung kann mithilfe eines alternativen Namensarrays erstellt werden, das in einem COM-Objekt des Erweiterungshandlers gespeichert ist. Jedes Element im Array ist eine Struktur, die eine Namenszeichenfolge und eine Namensauswahl enthält.

Diese Schnittstelle eignet sich zum Codieren und Decodieren szOID_SUBJECT_ALT_NAME2 Erweiterungen "2.5.29.17". Das SDK-Beispielrichtlinienmodul verwendet diese Schnittstelle.

ICertEncodeAltName ist in Certenc.h definiert. Wenn Sie Ihr Programm erstellen, verwenden Sie jedoch Certsrv.h als Include-Datei. Certenc.dll stellt die ICertEncodeAltName-Schnittstelle bereit. Die Typinformationen für diese Schnittstelle befinden sich ebenfalls in Certencl.dll, das mit dem Platform Software Development Kit (SDK) ausgeliefert wird.

Certificate Services-Schnittstellen unterstützen sowohl Apartmentthreading- als auch Free-Threading-Modelle. Für einen besseren Durchsatz wird freies Threading empfohlen.

Vererbung

Die ICertEncodeAltName-Schnittstelle erbt von der IDispatch-Schnittstelle . ICertEncodeAltName verfügt auch über die folgenden Membertypen:

Methoden

Die ICertEncodeAltName-Schnittstelle verfügt über diese Methoden.

ICertEncodeAltName::D ecode Decodiert eine asn.1-codierte alternative Namenserweiterung mit abstrakter Syntax Notation 1 (Asn.1) und speichert das resultierende Array von Zeichenfolgen im CertEncodeAltName-Objekt.
ICertEncodeAltName::Encode Gibt eine ASN.1-codierte Zeichenfolge des alternativen Namensarrays zurück, das in diesem Objekt gespeichert ist. Die Namen im Objekt sind nicht codiert.
ICertEncodeAltName::GetName Gibt den angegebenen Namen aus dem Alternativen Namenarray zurück.
ICertEncodeAltName::GetNameChoice Gibt die Namensauswahl in einem angegebenen Index eines Arrays mit alternativen Namen zurück.
ICertEncodeAltName::GetNameCount Gibt die Anzahl der Namen im Array des alternativen Namens zurück.
ICertEncodeAltName::Reset Gibt die Größe des Arrays mit alternativen Namen in diesem Objekt an. Der Wert aller Elemente im Array ist auf 0 festgelegt.
ICertEncodeAltName::SetNameEntry Legt einen Namen auf einen angegebenen Index des Alternativen Namensarrays fest.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	certenc.h (include Certsrv.h)