Funzione CertSelectionGetSerializedBlob (cryptuiapi.h)

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 l'archivio certificati e le informazioni 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 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.

Osservazioni:

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	non NULL	I certificati a cui punta il membro prgpChain vengono serializzati.
non NULL	NULL	I certificati specificati dal membro hStore vengono serializzati.
NULL	NULL	Viene restituito un BLOB vuoto.
non NULL	non NULL	La chiamata ha esito negativo e la funzione restituisce E_INVALIDARG.

Requisiti

Requisito	Value
Client minimo supportato	Windows 7 [solo applicazioni desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Header	cryptuiapi.h
Library	cryptui.lib
DLL	Cryptui.dll