CertSelectionGetSerializedBlob-Funktion (cryptuiapi.h)

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.

Anforderungen