ISCardISO7816::GetData-Methode

Artikel
06/13/2023

[Die GetData-Methode steht für die Verwendung in den Betriebssystemen zur Verfügung, 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 GetData-Methode erstellt einen APDU-Befehl ( Application Protocol Data Unit ), der abhängig vom Typ der ausgewählten Datei 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 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
S_OK	Operation erfolgreich abgeschlossen.
E_INVALIDARG	Ungültiger Parameter.
E_POINTER	Ein fehlerhafter Zeiger wurde übergeben.
E_OUTOFMEMORY	Nicht genügend Arbeitsspeicher.

Bemerkungen

Der gekapselte Befehl kann nur ausgeführt werden, wenn die sicherheitsrelevante status des intelligenten Karte die Sicherheitsattribute der zu lesenden Elementardatei erfüllt. Die Sicherheitsbedingungen hängen von der Richtlinie des Karte ab und können über ExternalAuthenticate, InternalAuthenticate, ISCardAuthauth usw. 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 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	Scardssp.h
Typbibliothek	Scardsrv.tlb
DLL	Scardssp.dll
IID	IID_ISCardISO7816 ist definiert als 53B6AA68-3F56-11D0-916B-00AA00C18068

Siehe auch

ExternalAuthenticate
InternalAuthenticate
ISCardAuth
ISCardISO7816
PutData
SelectFile

Freigeben über