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 |
|
| DLL |
|
| Nomi Unicode e ANSI |
CryptUIDlgSelectCertificateW (Unicode) e CryptUIDlgSelectCertificateA (ANSI) |