IX509ExtensionTemplate::InitializeEncode-Methode (certenroll.h)
Die InitializeEncode-Methode initialisiert die Erweiterung aus einem Vorlagenobjektbezeichner (OID) und aus Haupt- und Nebenversionsnummern. Diese Methode ist webfähig.
Syntax
HRESULT InitializeEncode(
[in] IObjectId *pTemplateOid,
[in] LONG MajorVersion,
[in] LONG MinorVersion
);
Parameter
[in] pTemplateOid
Zeiger auf eine IObjectId-Schnittstelle , die die Vorlagen-OID darstellt.
[in] MajorVersion
Eine LONG-Variable , die die Hauptversionsnummer der Vorlage enthält. Der Standardwert ist 0 (null).
[in] MinorVersion
Eine LONG-Variable , die die Nebenversionsnummer der Vorlage enthält. Der Standardwert ist 0 (null).
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 |
|---|---|
|
Das Objekt ist bereits initialisiert. |
Hinweise
Sie müssen entweder InitializeEncode oder InitializeDecode aufrufen, bevor Sie ein IX509ExtensionTemplate-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 die OID ab.
- Die Eigenschaften MajorVersion und MinorVersion rufen die Versionsinformationen ab.
- Die TemplateOid-Eigenschaft ruft die OID der Vorlage ab.
Sie müssen entweder InitializeEncode oder InitializeDecode aufrufen, bevor Sie ein IX509ExtensionBasicConstraints-Objekt verwenden können. Die beiden Methoden ergänzen sich. Mit der InitializeEncode-Methode können Sie eine codierte ASN.1-Struktur aus Rohdaten erstellen, und mit der InitializeDecode-Methode können Sie die Rohdaten aus einer codierten ASN.1-Struktur initialisieren. Sie können die Rohdaten für die Erweiterung abrufen, indem Sie die Eigenschaften MajorVersion, MinorVersion und TemplateOid aufrufen.
Anforderungen
| 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 |