Funzione CryptUIDlgSelectCertificate

La funzione CryptUIDlgSelectCertificate visualizza una finestra di dialogo che consente a un utente di selezionare un certificato.

Sintassi

PCCERT_CONTEXT WINAPI CryptUIDlgSelectCertificate(
  _In_  PCCRYPTUI_SELECTCERTIFICATE_STRUCT pcsc
);

Parametri

pcsc [in]

Puntatore a una struttura CRYPTUI_SELECTCERTIFICATE_STRUCT che contiene informazioni sulla finestra di dialogo da visualizzare.

Valore restituito

Puntatore a una struttura CERT_CONTEXT che rappresenta il certificato selezionato dall'utente. Al termine dell'uso di questo certificato, è necessario passare questo puntatore alla funzione CertFreeCertificateContext per decrerere il conteggio dei riferimenti del contesto del certificato.

Se il membro dwFlags della struttura pcsc non contiene il flag di CRYPTUI_SELECTCERT_MULTISELECT , un valore restituito null indica che l'utente ha chiuso la finestra di dialogo senza selezionare un certificato.

Se il membro dwFlags della struttura pcsc contiene il flag di CRYPTUI_SELECTCERT_MULTISELECT , questa funzione restituisce sempre NULL. I certificati selezionati saranno contenuti nell'archivio certificati rappresentato dal membro hSelectedCertStore di pcsc. Se il numero di certificati nell'archivio è lo stesso prima e dopo aver chiamato CryptUIDlgSelectCertificate, l'utente ha chiuso la finestra di dialogo senza selezionare alcun certificato.

Commenti

Se il membro dwFlags della struttura CRYPTUI_SELECTCERTIFICATE_STRUCT è impostato su CRYPTUI_SELECTCERT_LEGACY, viene visualizzata la finestra di dialogo legacy. In caso contrario, viene visualizzata la finestra di dialogo di selezione del certificato corrente.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Fine del supporto	Windows 7 [solo app desktop]
Libreria	Cryptui.lib
DLL	Cryptui.dll
Nomi Unicode e ANSI	CryptUIDlgSelectCertificateW (Unicode) e CryptUIDlgSelectCertificateA (ANSI)

Vedi anche

CRYPTUI_SELECTCERTIFICATE_STRUCT