CertSelectionGetSerializedBlob-Funktion (cryptuiapi.h)

  • Artikel

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