IX509ExtensionBasicConstraints::InitializeEncode-Methode (certenroll.h)

Die InitializeEncode-Methode initialisiert die Erweiterung von einem booleschen Wert, der angibt, ob es sich bei dem Zertifikatbetreff um eine Zertifizierungsstelle (Ca) und eine ganze Zahl handelt, die die Tiefe der untergeordneten Zertifizierungsstellenkette enthält.

Syntax

HRESULT InitializeEncode(
  [in] VARIANT_BOOL IsCA,
  [in] LONG         PathLenConstraint
);

Die Parameter

[in] IsCA

Eine VARIANT_BOOL Variable, die angibt, ob es sich bei dem Zertifikatbetreff um eine Zertifizierungsstelle handelt.

[in] PathLenConstraint

Eine LONG-Variable , die die maximale Anzahl von Zertifikaten in der Kette 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ö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

Die Methode ordnet die Namensauflistung dem XCN_OID_BASIC_CONSTRAINTS2 (2.5.29.19)- Objektbezeichner (OID) zu und codiert sie mithilfe von Distinguished Encoding Rules (DER).

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 ein DER-codiertes abstraktes Syntaxnotation One -Erweiterungsobjekt (ASN.1) 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 IsCA-Eigenschaft gibt an, ob es sich bei dem Zertifikatbetreff um eine Zertifizierungsstelle handelt.
• Die PathLenConstraint-Eigenschaft identifiziert die Tiefe der untergeordneten Zertifizierungsstellenkette.

Anforderungen

Siehe auch

IX509ExtensionBasicConstraints