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

  1. Erstellen Sie eine ISCard-Schnittstelle, und stellen Sie eine Verbindung mit einer Smartcard her.
  2. Erstellen Sie eine ISCardCmd-Schnittstelle.
  3. Erstellen Sie einen Smartcard-APDU-Befehl mithilfe der ISCardISO7816-Schnittstelle oder einer der ISCardCmd-Buildmethoden.
  4. Führen Sie den Befehl auf der Smartcard aus, indem Sie die entsprechende ISCard-Schnittstellenmethode aufrufen.
  5. Werten Sie die zurückgegebene Antwort aus.
  6. Wiederholen Sie die Prozedur nach Bedarf.
  7. 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
Ddat.h
Typbibliothek
Ddat.tlb
DLL
Scardssp.dll
IID
IID _ ISCardCmd ist als D5778AE3-43DE-11D0-9171-00AA00C18068 definiert.