CertSerializeCRLStoreElement-Funktion (wincrypt.h)

  • Artikel

Die CertSerializeCRLStoreElement-Funktion serialisiert einen codierten CRL-Kontext (Certificate Revocation List) und die codierte Darstellung seiner Eigenschaften. Das Ergebnis kann im Speicher beibehalten werden, sodass die Zertifikatsperrliste und die Eigenschaften zu einem späteren Zeitpunkt abgerufen werden können.

Syntax

BOOL CertSerializeCRLStoreElement(
  [in]      PCCRL_CONTEXT pCrlContext,
  [in]      DWORD         dwFlags,
  [out]     BYTE          *pbElement,
  [in, out] DWORD         *pcbElement
);

Parameter

[in] pCrlContext

Ein Zeiger auf die CRL_CONTEXT Struktur, die serialisiert wird.

[in] dwFlags

Für die zukünftige Verwendung reserviert und muss null sein.

[out] pbElement

Ein Zeiger auf einen Puffer zum Empfangen der serialisierten Ausgabe, einschließlich der codierten CRL und möglicherweise deren Eigenschaften.

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

[in, out] pcbElement

Ein Zeiger auf einen DWORD-Wert , der die Größe des Puffers in Bytes angibt, auf den der pbElement-Parameter verweist. Wenn die Funktion zurückgibt, enthält der DWORD-Wert die Anzahl der im Puffer gespeicherten Bytes.

Hinweis Bei der Verarbeitung der im Puffer zurückgegebenen Daten müssen Anwendungen die tatsächliche Größe der zurückgegebenen Daten verwenden. Die tatsächliche Größe kann etwas kleiner als die Größe des bei der Eingabe angegebenen Puffers sein. (Bei der Eingabe werden Puffergrößen in der Regel groß genug angegeben, um sicherzustellen, dass die größtmöglichen Ausgabedaten in den Puffer passen.) Bei der Ausgabe wird die Variable aktualisiert, auf die dieser Parameter verweist, um die tatsächliche Größe der in den Puffer kopierten Daten widerzuspiegeln.
 

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert TRUE.

Wenn die Funktion fehlschlägt, ist der Rückgabewert FALSE. Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen zu erhalten.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows XP [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile wincrypt.h
Bibliothek Crypt32.lib
DLL Crypt32.dll

Weitere Informationen

CertAddSerializedElementToStore

Zertifikatsperrlistenfunktionen