IX509Extension::Initialize-Methode (certenroll.h)
Die Initialize-Methode initialisiert ein IX509Extension-Objekt mithilfe eines Objektbezeichners (OID) und eines Bytearrays, das die Distinguished Encoding Rules (DER)-codierte Erweiterung enthält. Das DER-codierte Bytearray wird durch eine Unicode-codierte Zeichenfolge dargestellt. Diese Methode ist webfähig.
Syntax
HRESULT Initialize(
[in] IObjectId *pObjectId,
[in] EncodingType Encoding,
[in] BSTR strEncodedData
);
Parameter
[in] pObjectId
Zeiger auf eine IObjectId-Schnittstelle , die die Erweiterung OID enthält.
[in] Encoding
Ein EncodingType-Enumerationswert , der den Typ der Unicode-Codierung angibt, die auf die Eingabezeichenfolge angewendet wird.
[in] strEncodedData
Eine BSTR-Variable , die den DER-codierten Erweiterungswert 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ö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 |
|---|---|
|
Die OID konnte nicht gefunden werden. |
Hinweise
Eine Zertifikaterweiterung besteht aus einer OID, einem booleschen Wert, der angibt, ob die Erweiterung kritisch ist, und einem Bytearray, das den Erweiterungswert enthält. Die Erweiterung wird durch einen ASN.1-Standard ( Abstract Syntax Notation One ) definiert und mithilfe von DER codiert. Sie müssen das DER-codierte Bytearray als eine Zeichenfolge angeben, die entweder eine reine binärsequenz ist oder Unicode-codiert ist. Sie können den Codierungstyp angeben, der auf die Zeichenfolge angewendet werden soll, indem Sie die EncodingType-Enumeration verwenden.
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 |