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 abruft, die diesen Teil des Inhalts einer transparent strukturierten Elementardatei angibt.
Syntax
HRESULT ReadBinary(
[in] BYTE byP1,
[in] BYTE byP2,
[in] LONG lBytesToRead,
[in, out] LPSCARDCMD *ppCmd
);
Parameter
-
byP1 [in]
-
Das Feld P1-P2, offset to the first byte to read from the beginning of the file. Wenn b8=1 in P1, dann b7 und b6 von P1 auf Null (RFU-Bits) festgelegt sind, sind b5 bis b1 von P1 ein kurzer EF-Bezeichner und P2 der Offset des ersten Byte, der in Dateneinheiten vom Anfang der Datei gelesen werden soll. Wenn b8=0 in P1, dann P1|| P2 ist der Offset des ersten Byte, das am Anfang der Datei in Dateneinheiten gelesen werden soll.
-
byP2 [in]
-
Das Feld P1-P2, offset to the first byte to read from the beginning of the file. Wenn b8=1 in P1, dann b7 und b6 von P1 auf Null (RFU-Bits) festgelegt sind, sind b5 bis b1 von P1 ein kurzer EF-Bezeichner und P2 der Offset des ersten Byte, der in Dateneinheiten vom Anfang der Datei gelesen werden soll. Wenn b8=0 in P1, dann P1|| P2 ist der Offset des ersten Byte, das am 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 es mit dem APDU-Befehl gefüllt, der von diesem Vorgang erstellt wurde. Wenn ppCmd auf NULL festgelegt wurde, wird ein Smart KarteISCardCmd-Objekt intern erstellt und mithilfe des ppCmd-Zeigers zurückgegeben.
Rückgabewert
Die -Methode gibt einen der folgenden möglichen Werte zurück.
| Rückgabecode | Beschreibung |
|---|---|
|
Operation erfolgreich abgeschlossen. |
|
Ungültiger Parameter. |
|
Ein fehlerhafter Zeiger wurde übergeben. |
|
Nicht genügend Arbeitsspeicher. |
Bemerkungen
Der gekapselte Befehl kann nur ausgeführt werden, wenn die sicherheitsrelevante status des intelligenten Karte die Sicherheitsattribute der zu verarbeitenden Elementardatei erfüllt.
Wenn der Befehl einen gültigen kurzen elementaren Bezeichner enthält, wird die Datei als aktuelle Elementardatei festgelegt.
Elementardateien 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 gibt diese Schnittstelle möglicherweise einen Intelligenten Karte Fehlercode zurück, wenn eine Smart Karte-Funktion aufgerufen wurde, um die Anforderung abzuschließen. Weitere Informationen finden Sie unter Smartcard-Rückgabewerte.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) |
Windows XP [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) |
Windows Server 2003 [nur Desktop-Apps] |
| Ende des Supports (Client) |
Windows XP |
| Ende des Supports (Server) |
Windows Server 2003 |
| Header |
|
| Typbibliothek |
|
| DLL |
|
| IID |
IID_ISCardISO7816 ist definiert als 53B6AA68-3F56-11D0-916B-00AA00C18068 |
Siehe auch