ISCardISO7816::ReadBinary-Methode

[Die ReadBinary-Methode ist für die Verwendung in den Betriebssystemen verfügbar, die im Abschnitt Anforderungen angegeben sind. 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 ReadBinary-Methode erstellt einen APDU-Befehl (Application Protocol Data Unit), der eine Antwortnachricht erhält, die diesen Teil des Inhalts einer transparent strukturierten elementaren Datei liefert.

Syntax

HRESULT ReadBinary(
  [in]      BYTE       byP1,
  [in]      BYTE       byP2,
  [in]      LONG       lBytesToRead,
  [in, out] LPSCARDCMD *ppCmd
);

Parameter

byP1 [ In]

Das P1-P2-Feld, offset zum ersten Byte, das vom Anfang der Datei gelesen werden soll. Wenn b8=1 in P1, b7 und b6 von P1 auf 0 (RFU-Bits) festgelegt sind, sind b5 bis b1 von P1 ein kurzer EF-Bezeichner, und P2 ist der Offset des ersten Byte, das vom Anfang der Datei in Dateneinheiten gelesen werden soll. Wenn b8=0 in P1 ist, ist P1 | | P2 der Offset des ersten Byte, das vom Anfang der Datei in Dateneinheiten gelesen werden soll.

byP2 [ In]

Das P1-P2-Feld, offset zum ersten Byte, das vom Anfang der Datei gelesen werden soll. Wenn b8=1 in P1, b7 und b6 von P1 auf 0 (RFU-Bits) festgelegt sind, sind b5 bis b1 von P1 ein kurzer EF-Bezeichner, und P2 ist der Offset des ersten Byte, das vom Anfang der Datei in Dateneinheiten gelesen werden soll. Wenn b8=0 in P1 ist, ist P1 | | P2 der Offset des ersten Byte, das vom Anfang der Datei in Dateneinheiten gelesen werden soll.

lBytesToRead [ In]

Anzahl der Bytes, die aus dem transparenten EF gelesen werden sollen.

Wenn das Feld Le nur Nullen enthält, sollten innerhalb des Grenzwerts von 256 für kurze Länge oder 65536 für erweiterte Länge alle Bytes bis zum Ende der Datei gelesen werden.

ppCmd [ in, out]

Bei der Eingabe ein Zeiger auf ein ISCardCmd-Schnittstellenobjekt oder NULL.

Bei der Rückgabe wird er mit dem APDU-Befehl gefüllt, der von diesem Vorgang erstellt wurde. Wenn ppCmd auf NULL festgelegt wurde, wird intern ein ISCardCmd-Smartcardobjekt erstellt und mit dem ppCmd-Zeiger zurückgegeben.

Rückgabewert

Die -Methode gibt einen der folgenden möglichen Werte zurück.

Rückgabecode Beschreibung
S _ OK
Operation erfolgreich abgeschlossen.
E _ INVALIDARG
Ungültiger Parameter.
E _ POINTER
Ein ungültiger Zeiger wurde übergeben.
E _ OUTOFMEMORY
Nicht genügend Arbeitsspeicher.

Hinweise

Der gekapselte Befehl kann nur ausgeführt werden, wenn der Sicherheitsstatus der Smartcard die Sicherheitsattribute der zu verarbeitenden elementaren Datei erfüllt.

Wenn der Befehl einen gültigen kurzen elementaren Bezeichner enthält, wird die Datei als aktuelle elementare Datei festgelegt.

Elementare Dateien ohne transparente Struktur können nicht gelöscht werden. Der gekapselte Befehl wird abgebrochen, wenn er auf eine elementare Datei ohne transparente Struktur angewendet wird.

Eine Liste aller von dieser Schnittstelle bereitgestellten Methoden finden Sie unter ISCardISO7816.

Zusätzlich zu den oben aufgeführten COM-Fehlercodes kann diese Schnittstelle einen Smartcardfehlercode zurückgeben, wenn eine Smartcardfunktion aufgerufen wurde, um die Anforderung abzuschließen. Weitere Informationen finden Sie unter Smartcard-Rückgabewerte.

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
Scardssp.h
Typbibliothek
Scardsrv.tlb
DLL
Scardssp.dll
IID
IID _ ISCardISO7816 ist als 53B6AA68-3F56-11D0-916B-00AA00C18068 definiert.

Weitere Informationen

EraseBinary

ISCardISO7816

UpdateBinary

WriteBinary