IX509ExtensionBasicConstraints::InitializeEncode-Methode (certenroll.h)
Die InitializeEncode-Methode initialisiert die Erweiterung aus einem booleschen Wert, der angibt, ob es sich bei dem Zertifikatsubjekt 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
);
Parameter
[in] IsCA
Eine VARIANT_BOOL Variable, die angibt, ob es sich bei dem Antragsteller 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, gibt sie einen HRESULT-Wert zurück, 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
Die Methode ordnet die Nameauflistung 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. Mit der InitializeEncode-Methode können Sie ein DER-codiertes ASN.1-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 die OID ab.
- Die IsCA-Eigenschaft gibt an, ob der Zertifikatsubjekt eine Zertifizierungsstelle sein kann.
- Die PathLenConstraint-Eigenschaft gibt die Tiefe der untergeordneten Zertifizierungsstellenkette an.
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 |