CertSelectionGetSerializedBlob-Funktion (cryptuiapi.h)

Artikel
02/24/2024

Die CertSelectionGetSerializedBlob-Funktion ist eine Hilfsfunktion, die zum Abrufen eines serialisierten Zertifikatblobs aus einer CERT_SELECTUI_INPUT-Struktur verwendet wird.

Syntax

HRESULT CertSelectionGetSerializedBlob(
  [in]  PCERT_SELECTUI_INPUT pcsi,
  [out] void                 **ppOutBuffer,
  [out] ULONG                *pulOutBufferSize
);

Parameter

[in] pcsi

Ein Zeiger auf eine CERT_SELECTUI_INPUT-Struktur , die zertifikatspeicher- und Zertifikatkontextketteninformationen enthält.

[out] ppOutBuffer

Die Adresse eines Zeigers auf einen Puffer, der das blob für serialisierte Zertifikate empfängt.

[out] pulOutBufferSize

Ein Zeiger auf eine ULONG , um die Größe des BLOB in Bytes zu empfangen, das im Puffer empfangen wird, auf den der ppOutBuffer-Parameter verweist.

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. Wenn sowohl die Parameter hStore als auch prgpChain nicht NULL sind, geben Sie E_INVALIDARG zurück. Eine Liste allgemeiner Fehlercodes finden Sie unter Allgemeine HRESULT-Werte.

Hinweise

Das zurückgegebene serialisierte BLOB wird an die CredUIPromptForWindowsCredentials-Funktion im parameter pvInAuthBuffer übergeben, damit ein Benutzer ein Zertifikat über die Benutzeroberfläche für die Anmeldeinformationsauswahl auswählen kann.

Die Zertifikate, die im BLOB serialisiert werden, das im Puffer zurückgegeben wird, auf den der ppOutBuffer-Parameter dieser Funktion verweist, sind von den Werten der hStore - und prgpChain-Member der CERT_SELECTUI_INPUT-Struktur abhängig.

hStore	prgpChain	Serialisierte Zertifikate
NULL	nicht NULL	Die Zertifikate, auf die vom prgpChain-Member verwiesen wird, werden serialisiert.
nicht NULL	NULL	Die vom hStore-Member angegebenen Zertifikate werden serialisiert.
NULL	NULL	Ein leeres BLOB wird zurückgegeben.
nicht NULL	nicht NULL	Der Aufruf schlägt fehl, und die Funktion gibt E_INVALIDARG zurück.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	cryptuiapi.h
DLL	Cryptui.dll

Freigeben über