IX509AttributeExtensions::InitializeDecode-Methode (certenroll.h)

  • Artikel

Die InitializeDecode-Methode initialisiert das Objekt aus einem Distinguished Encoding Rules (DER)-codierten Bytearray, das den Attributwert enthält. Das 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 die Eingabezeichenfolge angewendet wird.

[in] strEncodedData

Eine BSTR-Variable , die die codierten Erweiterungen 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. Eine Liste allgemeiner Fehlercodes finden Sie unter Allgemeine HRESULT-Werte.

Hinweise

Der Objektbezeichner (OID) für dieses Attribut ist XCN_OID_RSA_certExtensions (1.2.840.113549.1.9.14). Weitere Informationen finden Sie unter CERTENROLL_OBJECTID.

Sie können diese Methode verwenden, wenn Sie über ein DER-codiertes ASN.1-Objekt verfügen, das einen Attributwert enthält. Sie müssen das DER-codierte Objekt in einer Unicode-codierten Zeichenfolge bereitstellen. Weitere Informationen finden Sie unter IBinaryConverter-Schnittstelle .

Sie müssen entweder InitializeEncode oder InitializeDecode aufrufen, bevor Sie ein IX509AttributeExtensions-Objekt verwenden können. Die beiden Methoden ergänzen sich. Mit der InitializeEncode-Methode können Sie eine codierte ASN.1-Struktur ( Abstract Syntax Notation One ) aus Rohdaten erstellen, und mit der InitializeDecode-Methode können Sie Rohdaten aus einer codierten ASN.1-Struktur initialisieren, die die Zertifikaterweiterungen enthält. Sie können die X509Extensions-Eigenschaft aufrufen, um die Erweiterungen abzurufen.

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

Weitere Informationen

IBinaryConverter

IX509Attribute

IX509AttributeExtensions

IX509Attributes