CertSerializeCTLStoreElement-Funktion (wincrypt.h)

Artikel
08/27/2023

Die CertSerializeCTLStoreElement-Funktion serialisiert einen codierten CTL-Kontext (Certificate Trust List) und die codierte Darstellung seiner Eigenschaften. Das Ergebnis kann im Speicher beibehalten werden, sodass die CTL und die Eigenschaften später abgerufen werden können.

Syntax

BOOL CertSerializeCTLStoreElement(
  [in]      PCCTL_CONTEXT pCtlContext,
  [in]      DWORD         dwFlags,
  [out]     BYTE          *pbElement,
  [in, out] DWORD         *pcbElement
);

Parameter

[in] pCtlContext

Ein Zeiger auf die CTL_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, der die serialisierte Ausgabe empfängt, einschließlich der codierten CTL und möglicherweise ihrer Eigenschaften.

Dieser Parameter kann NULL sein, um die Größe dieser Informationen für Speicherzuordnungszwecke festzulegen. Weitere Informationen finden Sie unter Abrufen von Daten 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 sein als die Größe des Puffers, der bei der Eingabe angegeben wird. (Bei der Eingabe werden Puffergrößen normalerweise 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

Anforderung	Wert
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

Zertifikatvertrauenslistenfunktionen

Freigeben über