IX509ExtensionTemplate::InitializeEncode-Methode (certenroll.h)

Die InitializeEncode-Methode initialisiert die Erweiterung aus einem Vorlagenobjektbezeichner (OID) und von Haupt- und Nebenversionsnummern. Diese Methode ist webfähig.

Syntax

HRESULT InitializeEncode(
  [in] IObjectId *pTemplateOid,
  [in] LONG      MajorVersion,
  [in] LONG      MinorVersion
);

Die Parameter

[in] pTemplateOid

Zeigen Sie auf eine IObjectId-Schnittstelle , die die OID-Vorlage darstellt.

[in] MajorVersion

Eine LONG-Variable , die die Hauptversionsnummer der Vorlage enthält. Die Standarddicke ist null (0).

[in] MinorVersion

Eine LONG-Variable , die die Nebenversionsnummer der Vorlage enthält. Die Standarddicke ist null (0).

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ögliche Werte sind die Werte in der folgenden Tabelle, sind jedoch nicht beschränkt. Eine Liste allgemeiner Fehlercodes finden Sie unter "Allgemeine HRESULT-Werte".

Bemerkungen

Sie müssen entweder InitializeEncode oder InitializeDecode aufrufen, bevor Sie ein IX509ExtensionTemplate-Objekt verwenden können. Die beiden Methoden ergänzen sich gegenseitig. Mit der InitializeEncode-Methode können Sie ein dediziertes abstraktes Syntaxnotation One (ASN.1)-Erweiterungsobjekt 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 das OID ab.
• Die Eigenschaften "MajorVersion " und "MinorVersion " rufen die Versionsinformationen ab.
• Die TemplateOid-Eigenschaft ruft das 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 gegenseitig. 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

Siehe auch

IX509ExtensionTemplate