CertSelectionGetSerializedBlob-Funktion (cryptuiapi.h)

Die CertSelectionGetSerializedBlob-Funktion ist eine Hilfsfunktion zum Abrufen eines serialisierten Zertifikat-BLOB aus einer CERT_SELECTUI_INPUT Struktur.

Syntax

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

Die Parameter

[in] pcsi

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

[out] ppOutBuffer

Die Adresse eines Zeigers auf einen Puffer, der die serialisierten Zertifikate BLOB empfängt.

[out] pulOutBufferSize

Ein Zeiger auf eine ULONG , um die Größe des BLOB in Bytes zu empfangen, das im Puffer empfangen wurde, 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 die Parameter "hStore " und "prgpChain " nicht NULL sind, geben Sie E_INVALIDARG zurück. Eine Liste allgemeiner Fehlercodes finden Sie unter "Allgemeine HRESULT-Werte".

Bemerkungen

Das zurückgegebene serialisierte BLOB wird an die CredUIPromptForWindowsCredentials-Funktion im pvInAuthBuffer-Parameter übergeben, damit ein Benutzer ein Zertifikat mithilfe der Benutzeroberfläche für die Auswahl von Anmeldeinformationen auswählen kann.

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

Anforderungen