Smartcard-Benutzeroberfläche

Die Smartcard Benutzeroberfläche (UI) ist ein einzelnes gängiges Dialogfeld, mit dem der Benutzer eine Smartcard zum Öffnen (d. b. herstellen und in einer Anwendung verwenden) angeben oder suchen kann.

Im Folgenden finden Sie zwei Möglichkeiten, das allgemeine Dialogfeld zu verwenden. Beide gehen davon aus, dass die Benutzeroberfläche des Dialogfelds angezeigt wird. Weitere Informationen finden Sie unter OPENCARDNAME.

So wählen Sie eine Smartcard aus, um zu öffnen

1. Deklarieren Sie eine Variable vom Typ OPENCARDNAME-.
2. Stellen Sie genügend Informationen im allgemeinen Dialogfeld bereit, um die Suche nach einer Smartcard einzugrenzen, nach der die aufrufende Anwendung sucht. Dazu gehören die Angabe lpstrGroupNames, lpstrCardNamesund rgguidInterfaces. Dies schließt auch die Angabe eines bevorzugten Freigabemodus und eines Protokolls ein, das verwendet werden soll, wenn das allgemeine Dialogfeld eine Verbindung mit der Karte mithilfe der dwShareMode und dwPreferredProtocols Member der OPENCARDNAME- Struktur herstellt.
3. Rufen Sie die GetOpenCardName--Funktion auf, um dem Benutzer das allgemeine Dialogfeld anzuzeigen. Eine einfache Hilfeinformationszeile wird angezeigt, und wenn eine der angeforderten Karten gefunden wird, wird die Karte in der Anzeige hervorgehoben. Bei mehreren Kartennamensuchen wird der erste Leser, der eine der bevorzugten Karten enthält, hervorgehoben.
4. Der Benutzer wählt dann eine Karte aus, klickt auf OKund stellt eine Verbindung mit der Smartcard herstellt.

So suchen Sie nach einer bestimmten Karte

1. Deklarieren Sie eine Variable vom Typ OPENCARDNAME-.

2. Stellen Sie genügend Informationen im allgemeinen Dialogfeld bereit, um die Suche nach einer Smartcard einzugrenzen, nach der die aufrufende Anwendung sucht. Dazu gehören die Angabe lpstrGroupNames, lpstrCardNamesund rgguidInterfaces.

3. Erstellen Sie die funktionen Connect, Checkund Disconnect callback functions, and set the lpfnConnect, lpfnCheck, and lpfnDisconnect data members entsprechend.

   Anmerkung

   Alle drei Funktionen und Member müssen verfügbar sein, wenn sie das allgemeine Dialogfeld auf diese Weise verwenden.

    

4. Rufen Sie die GetOpenCardName allgemeine Dialogfeldfunktion auf.

5. Das allgemeine Dialogfeld sucht dann nach den angeforderten Karten. Wenn ein übereinstimmende Kartenname oder ATR-Zeichenfolge gefunden wird, werden die Connect-, Überprüfenund Trennen Rückruffunktionen in Sequenz aufgerufen. Wenn eine Karte die Check Routine übergibt (d. h. die Check Rückruf gibt TRUEzurück), wird diese Karte im Display für den Benutzer hervorgehoben.

   Anmerkung

   Wenn mehrere Kartennamen angegeben werden, wird der erste Leser, der eine der angeforderten Karten enthält, die Check Routine die ausgewählte Karte sein.

    

6. Wenn keine Übereinstimmungen gefunden werden, wird ein allgemeines Dialogfeld angezeigt.