ISCardCmd-Schnittstelle
[Die ISCardCmd-Schnittstelle ist für die Verwendung in den im Abschnitt Anforderungen angegebenen Betriebssystemen verfügbar. Es ist nicht für die Verwendung in Windows Server 2003 mit Service Pack 1 (SP1) und höher, Windows Vista, Windows Server 2008 und nachfolgenden Versionen des Betriebssystems verfügbar. Die Smartcardmodule bieten ähnliche Funktionen.]
Die ISCardCmd-Schnittstelle stellt die Methoden bereit, die zum Erstellen und Verwalten einer Smartcard-APDU (Application Protocol Data Unit) erforderlich sind. Diese Schnittstelle kapselt zwei Puffer:
- Der APDU-Puffer enthält die Befehlssequenz, die an die Karte gesendet wird.
- Der APDUReply-Puffer enthält Daten, die von der Karte nach Ausführung des APDU-Befehls zurückgegeben werden (diese Daten werden auch als Rückgabe-APDU bezeichnet).
Das folgende Beispiel zeigt eine typische Verwendung der ISCardCmd-Schnittstelle. Die ISCardCmd-Schnittstelle wird verwendet, um eine APDU zu erstellen.
So übermitteln Sie eine Transaktion an eine bestimmte Karte
- Erstellen Sie eine ISCard-Schnittstelle, und stellen Sie eine Verbindung mit einer Smartcard her.
- Erstellen Sie eine ISCardCmd-Schnittstelle.
- Erstellen Sie einen Smartcard-APDU-Befehl mithilfe der ISCardISO7816-Schnittstelle oder einer der ISCardCmd-Buildmethoden.
- Führen Sie den Befehl auf der Smartcard aus, indem Sie die entsprechende ISCard-Schnittstellenmethode aufrufen.
- Werten Sie die zurückgegebene Antwort aus.
- Wiederholen Sie die Prozedur nach Bedarf.
- Geben Sie die ISCardCmd-Schnittstelle und andere nach Bedarf frei.
Member
Die ISCardCmd-Schnittstelle erbt von der IDispatch-Schnittstelle. ISCardCmd verfügt auch über diese Typen von Membern:
Methoden
Die ISCardCmd-Schnittstelle verfügt über diese Methoden.
| Methode | BESCHREIBUNG |
|---|---|
| BuildCmd | Erstellt eine gültige Befehls-APDU für die Übertragung an eine Smartcard. |
| Klar | Löscht die APDU- und Antwort-APDU-Nachrichtenpuffer. |
| Kapseln | Kapselt die angegebene Befehls-APDU in eine andere Befehls-APDU für die Übertragung an eine Smartcard. |
Eigenschaften
Die ISCardCmd-Schnittstelle verfügt über diese Eigenschaften.
| Eigenschaft | Zugriffstyp | BESCHREIBUNG |
|---|---|---|
| AlternateClassId |
Lesen/Schreiben |
Aktueller id-Wert der alternativen Klasse. |
| Apdu |
Lesen/Schreiben |
Unformatierte ApDU (Application Protocol Data Unit). |
| ApduLength |
Schreibgeschützt |
Länge des APDU. |
| ApduReply |
Lesen/Schreiben |
Antwort-APDU. |
| ApduReplyLength |
Lesen/Schreiben |
Länge des Antwort-APDU. |
| Classid |
Lesen/Schreiben |
Klassen-ID der APDU. |
| Daten |
Schreibgeschützt |
Datenfeld der APDU. |
| InstructionId |
Lesen/Schreiben |
Anweisungs-ID-Byte aus der APDU. |
| LeField |
Schreibgeschützt |
Le-Feld der APDU. |
| Nad |
Lesen/Schreiben |
Knotenadresse. |
| P1 |
Lesen/Schreiben |
Erstes Parameter byte der APDU. |
| P2 |
Lesen/Schreiben |
Zweites Parameter byte der APDU. |
| P3 |
Schreibgeschützt |
Drittes Parameter byte der APDU. |
| ReplyNad |
Lesen/Schreiben |
Knotenadresse, die von der Karte in der Antwortnachricht verwendet wird. |
| ReplyStatus |
Lesen/Schreiben |
Antwort-APDU-Meldungsstatuswort. |
| ReplyStatusSW1 |
Schreibgeschützt |
Antwort-APDU-Nachricht SW1-Status byte. |
| ReplyStatusSW2 |
Schreibgeschützt |
Antwort-APDU-Nachrichten-SW2-Status byte. |
| Typ |
Schreibgeschützt |
Für die zukünftige Verwendung reserviert. |
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows [Nur XP-Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Nur Server [ 2003-Desktop-Apps] |
| Ende des Supports (Client) |
Windows XP |
| Ende des Supports (Server) |
Windows Server 2003 |
| Header |
|
| Typbibliothek |
|
| DLL |
|
| IID |
IID _ ISCardCmd ist als D5778AE3-43DE-11D0-9171-00AA00C18068 definiert. |