CryptDecodeObject-Funktion (wincrypt.h)

Die CryptDecodeObject-Funktion decodiert eine Struktur des Typs, der durch den lpszStructType-Parameter angegeben wird. Die Verwendung von CryptDecodeObjectEx wird als API empfohlen, die dieselbe Funktion mit erheblichen Leistungsverbesserungen ausführt.

Syntax

BOOL CryptDecodeObject(
  [in]      DWORD      dwCertEncodingType,
  [in]      LPCSTR     lpszStructType,
  [in]      const BYTE *pbEncoded,
  [in]      DWORD      cbEncoded,
  [in]      DWORD      dwFlags,
  [out]     void       *pvStructInfo,
  [in, out] DWORD      *pcbStructInfo
);

Parameter

[in] dwCertEncodingType

Verwendeter Codierungstyp. Es ist immer akzeptabel, sowohl den Zertifikat- als auch den Nachrichtencodierungstyp anzugeben, indem sie mit einem bitweisen OR-Vorgang kombiniert werden, wie im folgenden Beispiel gezeigt:

X509_ASN_ENCODING | PKCS_7_ASN_ENCODING

Derzeit definierte Codierungstypen sind:

• X509_ASN_ENCODING
• PKCS_7_ASN_ENCODING

[in] lpszStructType

Ein Zeiger auf eine OID, die den Strukturtyp definiert. Wenn das Wort mit hoher Ordnung des lpszStructType-Parameters null ist, gibt das Wort mit niedriger Ordnung den ganzzahligen Bezeichner für den Typ der angegebenen Struktur an. Andernfalls ist dieser Parameter ein langer Zeiger auf eine Zeichenfolge mit NULL-Beendigung.

Weitere Informationen zu Objektbezeichnerzeichenfolgen, ihren vordefinierten Konstanten und entsprechenden Strukturen finden Sie unter Konstanten für CryptEncodeObject und CryptDecodeObject.

[in] pbEncoded

Ein Zeiger auf die codierte Struktur, die decodiert werden soll.

[in] cbEncoded

Anzahl der Bytes, auf die pbEncoded verweist.

[in] dwFlags

Die folgenden Flags sind definiert. Sie können mit einer bitweisen OR-Operation kombiniert werden.

[out] pvStructInfo

Ein Zeiger auf einen Puffer zum Empfangen der decodierten Struktur. Wenn der angegebene Puffer nicht groß genug ist, um die decodierte Struktur zu empfangen, legt die Funktion den ERROR_MORE_DATA Code fest und speichert die erforderliche Puffergröße in Bytes in der Variablen, auf die von pcbStructInfo verwiesen wird.

Dieser Parameter kann NULL sein, um die Größe dieser Informationen für die Speicherbelegung abzurufen. Weitere Informationen finden Sie unter Abrufen von Daten mit unbekannter Länge.

[in, out] pcbStructInfo

Ein Zeiger auf einen DWORD-Wert , der die Größe des Puffers in Bytes angibt, auf den der parameter pvStructInfo verweist. Wenn die Funktion zurückgibt, enthält dieser DWORD-Wert die Größe der decodierten Daten, die in pvStructInfo kopiert wurden. Die in der Variable enthaltene Größe, auf die von pcbStructInfo verwiesen wird, kann eine Größe angeben, die größer als die decodierte Struktur ist, da die decodierte Struktur Zeiger auf andere Strukturen enthalten kann. Diese Größe ist die Summe der Größe, die von der decodierten Struktur und anderen Strukturen benötigt wird, auf die verwiesen wird.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich null (TRUE).

Wenn die Funktion fehlschlägt, ist der Rückgabewert 0 (FALSE). Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen zu erhalten. Einige mögliche Fehlercodes sind in der folgenden Tabelle aufgeführt.

Wenn die Funktion fehlschlägt, gibt GetLastError möglicherweise einen ASN.1-Codierungs-/Decodierungsfehler ( Abstract Syntax Notation One ) zurück. Informationen zu diesen Fehlern finden Sie unter ASN.1-Rückgabewerte für Codierung/Decodierung.

Hinweise

Beim Codieren eines kryptografischen Objekts mit der bevorzugten CryptEncodeObjectEx-Funktion wird das abschließende NULL-Zeichen eingeschlossen. Beim Decodieren mit der bevorzugten CryptDecodeObjectEx-Funktion wird das abschließende NULL-Zeichen nicht beibehalten.

Beispiele

Ein Beispiel, das diese Funktion verwendet, finden Sie unter Beispiel-C-Programm: ASN.1-Codierung und -Decodierung.

Anforderungen

Weitere Informationen

CryptDecodeObjectEx

CryptEncodeObject

Objektcodierungs- und Decodierungsfunktionen