Funzione CertSelectionGetSerializedBlob (cryptuiapi.h)

  • Articolo

La funzione CertSelectionGetSerializedBlob è una funzione helper usata per recuperare un BLOB di certificati serializzato da una struttura di CERT_SELECTUI_INPUT .

Sintassi

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

Parametri

[in] pcsi

Puntatore a una struttura CERT_SELECTUI_INPUT che contiene le informazioni sull'archivio certificati e sulla catena di contesto del certificato.

[out] ppOutBuffer

Indirizzo di un puntatore a un buffer che riceve il BLOB dei certificati serializzati.

[out] pulOutBufferSize

Puntatore a un ULONG per ricevere le dimensioni, in byte, del BLOB ricevuto nel buffer a cui punta il parametro ppOutBuffer .

Valore restituito

Se la funzione ha esito positivo, la funzione restituisce S_OK.

Se la funzione ha esito negativo, restituisce un valore HRESULT che indica l'errore. Se entrambi i parametri hStore e prgpChain non sono NULL, restituire E_INVALIDARG. Per un elenco dei codici di errore comuni, vedere Valori HRESULT comuni.

Commenti

Il BLOB serializzato restituito viene passato alla funzione CredUIPromptForWindowsCredentials nel parametro pvInAuthBuffer per consentire a un utente di selezionare un certificato usando l'interfaccia utente di selezione delle credenziali.

I certificati serializzati nel BLOB restituiti nel buffer a cui punta il parametro ppOutBuffer di questa funzione dipendono dai valori dei membri hStore e prgpChain della struttura CERT_SELECTUI_INPUT .

hStore prgpChain Certificati serializzati
NULL not NULL I certificati a cui punta il membro prgpChain vengono serializzati.
not NULL NULL I certificati specificati dal membro hStore vengono serializzati.
NULL NULL Viene restituito un BLOB vuoto.
not NULL not NULL La chiamata ha esito negativo e la funzione restituisce E_INVALIDARG.

Requisiti

Requisito Valore
Client minimo supportato Windows 7 [solo app desktop]
Server minimo supportato Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione Windows
Intestazione cryptuiapi.h
DLL Cryptui.dll