Interfaccia utente smart card
L'interfaccia utente della smart card è una singola finestra di dialogo comune che consente all'utente di specificare o cercare una smart card da aprire, ovvero connettersi e usarla in un'applicazione.
Di seguito sono riportati due modi per usare la finestra di dialogo comune. Entrambi presuppongono che venga visualizzata l'interfaccia utente della finestra di dialogo. Per altre informazioni, vedere OPENCARDNAME.
Per selezionare una smart card da aprire
- Dichiarare una variabile di tipo OPENCARDNAME.
- Fornire informazioni sufficienti nella finestra di dialogo comune per restringere la ricerca di una smart card che l'applicazione chiamante sta cercando. Ciò include la specifica di lpstrGroupNames, lpstrCardNames e rgguidInterfaces. Ciò include anche la specifica di una modalità di condivisione preferita e un protocollo da usare quando la finestra di dialogo comune si connette alla scheda usando i membri dwShareMode e dwPreferredProtocols della struttura OPENCARDNAME .
- Chiamare la funzione GetOpenCardName per visualizzare la finestra di dialogo comune all'utente. Verrà visualizzata una semplice riga di informazioni della Guida e, se viene trovata una delle schede richieste, la scheda verrà evidenziata nella visualizzazione. Per le ricerche con più nomi di scheda, il primo lettore che contiene una delle schede preferite verrà evidenziato.
- L'utente seleziona quindi una scheda, fa clic su OK e si connette alla smart card.
Per cercare una scheda specifica
Dichiarare una variabile di tipo OPENCARDNAME.
Fornire informazioni sufficienti nella finestra di dialogo comune per restringere la ricerca di una smart card che l'applicazione chiamante sta cercando. Ciò include la specifica di lpstrGroupNames, lpstrCardNames e rgguidInterfaces.
Creare le funzioni di callback Connect, Check e Disconnect e impostare i membri dati lpfnConnect, lpfnCheck e lpfnDisconnect in modo appropriato.
Nota
Tutte e tre le funzioni e i membri devono essere disponibili quando si usa la finestra di dialogo comune in questo modo.
Chiamare la funzione della finestra di dialogo comune GetOpenCardName .
La finestra di dialogo comune cercherà quindi le schede richieste. Se viene trovato un nome di scheda corrispondente o una stringa ATR , le funzioni di callback Connect, Check e Disconnect verranno chiamate in sequenza. Se una scheda passa la routine Check , ovvero il callback Check restituisce TRUE, questa scheda viene evidenziata nella visualizzazione all'utente.
Nota
Se vengono assegnati più nomi di scheda, il primo lettore che contiene una delle schede richieste e passa la routine Check sarà la scheda selezionata.
Se non vengono trovate corrispondenze, verrà visualizzata una finestra di dialogo comune.