ISCardISO7816::GetData-Methode

[Die GetData-Methode 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 GetData-Methode erstellt einen APDU-Befehl (Application Protocol Data Unit), der je nach ausgewähltem Dateityp entweder ein einzelnes primitives Datenobjekt oder einen Satz von Datenobjekten (in einem konstruierten Datenobjekt enthalten) abruft.

Syntax

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

Parameter

byP1 [ In]

Parameter.

Wert Bedeutung
0000 - 003F
RFU
0040 - 00FF
BER-TLV-Tag (1 Byte) in P2
0100 - 01FF
Anwendungsdaten (proprietäre Codierung)
0200 - 02FF
SIMPLE-TLV-Tag in P2
0300 - 03FF
RFU
0400 - 04FF
BER-TLV-Tag (2 Bytes) in P1-P2

byP2 [ In]

Parameter.

Wert Bedeutung
0000 - 003F
RFU
0040 - 00FF
BER-TLV-Tag (1 Byte) in P2
0100 - 01FF
Anwendungsdaten (proprietäre Codierung)
0200 - 02FF
SIMPLE-TLV-Tag in P2
0300 - 03FF
RFU
0400 - 04FF
BER-TLV-Tag (2 Bytes) in P1-P2

lBytesToGet [ In]

Anzahl der in der Antwort erwarteten Bytes.

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.

Bemerkungen

Der gekapselte Befehl kann nur ausgeführt werden, wenn der Sicherheitsstatus der Smartcard die Sicherheitsattribute der zu lesenden elementaren Datei erfüllt. Sicherheitsbedingungen sind von der Richtlinie der Karte abhängig und können über ExternalAuthenticate, InternalAuthenticate, ISCardAuthusw. bearbeitet werden.

Um eine Datei auszuwählen, rufen Sie SelectFile auf.

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.

Requirements (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

ExternalAuthenticate

InternalAuthenticate

ISCardAuth

ISCardISO7816

PutData

SelectFile