IX509ExtensionTemplateName::InitializeEncode-Methode (certenroll.h)

Artikel
08/22/2023

Die InitializeEncode-Methode initialisiert die Erweiterung aus einer Zeichenfolge, die den Vorlagennamen enthält. Diese Methode ist webfähig.

Syntax

HRESULT InitializeEncode(
  [in] BSTR strTemplateName
);

Parameter

[in] strTemplateName

Eine BSTR-Variable , die den Namen enthält.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt die Funktion S_OK zurück.

Wenn die Funktion fehlschlägt, wird ein HRESULT-Wert zurückgegeben, der den Fehler angibt. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle. Eine Liste allgemeiner Fehlercodes finden Sie unter Allgemeine HRESULT-Werte.

Rückgabecode/-wert	BESCHREIBUNG
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)	Das Objekt ist bereits initialisiert.

Hinweise

Sie müssen entweder InitializeEncode oder InitializeDecode aufrufen, bevor Sie ein IX509ExtensionTemplateName-Objekt verwenden können. Die beiden Methoden ergänzen sich. Mit der InitializeEncode-Methode können Sie ein ASN.1-Erweiterungsobjekt (DISTINGUISHED ENCODING RULES)-codiert (ABSTRACT Syntax Notation One) aus Rohdaten erstellen, und mit der InitializeDecode-Methode können Sie die Rohdaten aus einem codierten Objekt initialisieren.

Sie können die folgenden Eigenschaften für diese Erweiterung abrufen:

Die Critical-Eigenschaft gibt an, ob die Erweiterung kritisch ist. Sie können diese Eigenschaft auch angeben.
Die ObjectId-Eigenschaft ruft den Objektbezeichner (Object Identifier, OID) ab.
Die TemplateName-Eigenschaft ruft den Vorlagennamen (die Rohdaten der Erweiterung) ab.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	certenroll.h
DLL	CertEnroll.dll

Weitere Informationen

IX509ExtensionTemplateName

Share via