IX509ExtensionKeyUsage::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
);
Parameter
[in] Encoding
Ein EncodingType-Enumerationswert , der den Typ der Unicode-Codierung angibt, die auf den strEncodedData-Parameter 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ö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
Sie können diese Methode verwenden, wenn Sie über ein DER-codiertes ASN.1-Objekt ( Abstract Syntax Notation One ) verfügen, das eine KeyUsage-Erweiterung enthält. Sie müssen das DER-codierte Objekt in einer Unicode-codierten Zeichenfolge angeben. Weitere Informationen finden Sie unter der IBinaryConverter-Schnittstelle .
Sie müssen entweder InitializeEncode oder InitializeDecode aufrufen, bevor Sie ein IX509ExtensionKeyUsage-Objekt verwenden können. Die beiden Methoden ergänzen sich. Mit der InitializeEncode-Methode können Sie ein DER-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 Erweiterungsobjektbezeichner (Extension Object Identifier , OID) ab.
- Die KeyUsage-Eigenschaft ruft die Einschränkungen ab, die die beabsichtigte Verwendung des öffentlichen Schlüssels (die Rohdaten der Erweiterung) identifizieren.
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 |