ICertEncodeStringArray-Schnittstelle (certenc.h)

Die ICertEncodeStringArray Schnittstelle stellt Methoden zum Behandeln von Zeichenfolgenarrays bereit, die in Zertifikaterweiterungen verwendet werden.

Eine Zertifikaterweiterung kann mithilfe eines Zeichenfolgenarrays erstellt werden, das in einem Erweiterungshandler gespeichert ist, COM-Objekt, das vom Richtlinienmodul instanziiert wird. Jedes Element im Array ist ein Zeichenfolgenwert.

Diese Schnittstelle wird hauptsächlich als Demonstration für die Codierung von benutzerdefinierten Erweiterungen bereitgestellt. Die Zertifikatdienste-Beispielprogramme im Platform Software Development Kit (SDK) enthalten Quellcode für diese Schnittstelle.

ICertEncodeStringArray wird in Certenc.h definiert. Wenn Sie Ihr Programm erstellen, verwenden Sie jedoch Certsrv.h als Includedatei. Certenc.dll stellt die ICertEncodeStringArray Schnittstelle bereit. Die Typinformationen für diese Schnittstelle sind auch in Certencl.dllenthalten, die mit dem Platform SDK ausgeliefert werden.

Zertifikatdiensteschnittstellen unterstützen sowohl Apartmentthreading- als auch Freithreadingmodelle. Für einen besseren Durchsatz wird freie Threading empfohlen.

Erbschaft

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

Methodik

Die ICertEncodeStringArray Schnittstelle hat diese Methoden.

ICertEncodeStringArray::D ecode Decodiert eine abstrakte Syntaxnotation One (ASN.1)-codiertes Zeichenfolgenarray und speichert das resultierende Array von Zeichenfolgen im CertEncodeStringArray-Objekt.
ICertEncodeStringArray::Encode Gibt eine ASN.1-codierte Zeichenfolge des in diesem Objekt gespeicherten Zeichenfolgenarrays zurück.
ICertEncodeStringArray::GetCount Gibt die Anzahl der Zeichenfolgenwerte im Zeichenfolgenarray zurück.
ICertEncodeStringArray::GetStringType Gibt den Typ der Zeichenfolgenwerte zurück, die das Zeichenfolgenarray enthält.
ICertEncodeStringArray::GetValue Gibt die angegebene Zeichenfolge aus dem Zeichenfolgenarray zurück.
ICertEncodeStringArray::Reset Gibt die Größe des Zeichenfolgenarrays und den Typ der Zeichenfolgen an, die das Array enthalten soll.
ICertEncodeStringArray::SetValue Legt einen Zeichenfolgenwert am angegebenen Index des Zeichenfolgenarrays fest.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Keine unterstützt
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	certenc.h (include Certsrv.h)