IX509ExtensionBasicConstraints::InitializeDecode-Methode (certenroll.h)

Die InitializeDecode-Methode initialisiert die Erweiterung aus einem distinguished Encoding Rules (DER)-codierten Bytearray, das den Erweiterungswert enthält. Das codierte Bytearray wird durch eine Unicode-codierte Zeichenfolge dargestellt.

Syntax

HRESULT InitializeDecode(
  [in] EncodingType Encoding,
  [in] BSTR         strEncodedData
);

Die Parameter

[in] Encoding

Ein EncodingType-Enumerationswert , der den Typ der Unicode-Codierung angibt, die auf den StrEncodedData-Wert angewendet wird.

[in] strEncodedData

Eine BSTR-Variable , die die DER-codierte Erweiterung 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

Sie können diese Methode verwenden, wenn Sie über ein DER-codiertes abstraktes SyntaxNotation One (ASN.1)-Objekt verfügen, das eine BasicConstraints-Erweiterung enthält. Sie müssen das DER-codierte Objekt in einer Unicode-codierten Zeichenfolge angeben. Weitere Informationen finden Sie in der IBinaryConverter-Schnittstelle .

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 DERN-codiertes 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 den Objektbezeichner (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