ISCardISO7816::AppendRecord-Methode

[Die AppendRecord-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 AppendRecord-Methode erstellt einen APDU-Befehl (Application Protocol Data Unit), der entweder einen Datensatz an das Ende einer linear strukturierten elementaren Datei (EF) anfügen oder Datensatznummer 1 in eine zyklisch strukturierte elementare Datei schreibt.

Syntax

HRESULT AppendRecord(
  [in]      BYTE         byRefCtrl,
  [in]      LPBYTEBUFFER pData,
  [in, out] LPSCARDCMD   *ppCmd
);

Parameter

byRefCtrl [ In]

Identifiziert die elementare Datei, die angefügt werden soll.

Wert Bedeutung
Aktuelles EF
Bitposition: 00000000
Kurze EF-ID
Bitposition: xxxxx000
Reserviert
Bitposition: xxxxxxxx

pData [ In]

Ein Zeiger auf die Daten, die an die Datei angefügt werden sollen.

Wert Bedeutung
Tn
1 Byte
Ln
1 oder 3 Bytes
Daten
Ln-Bytes

ppCmd [ in, out]

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

Bei der Rückgabe wird er mit dem von diesem Vorgang erstellten APDU-Befehl gefüllt. Wenn ppCmd auf NULL festgelegt wurde, wird intern ein SMARTCARD-ISCardCmd-Objekt 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-ZEIGER
Ein fehlerhafter Zeiger wurde übergeben.
E _ OUTOFMEMORY
Nicht genügend Arbeitsspeicher.

Bemerkungen

Der gekapselte Befehl kann nur ausgeführt werden, wenn der Sicherheitsstatus der Smartcard den Sicherheitsattributen der elementar gelesenen Datei entspricht.

Wenn zum Zeitpunkt der Ausgabe dieses Befehls eine andere elementare Datei ausgewählt wird, kann sie ohne Identifizierung der aktuell ausgewählten Datei verarbeitet werden.

Elementare Dateien ohne Datensatzstruktur können nicht gelesen werden. Der gekapselte Befehl wird abgebrochen, wenn er auf eine elementare Datei ohne Datensatzstruktur 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 Smartcard-Fehlercode zurück, wenn eine Smartcardfunktion aufgerufen wurde, um die Anforderung zu erfüllen. 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

ISCardISO7816

ReadRecord

UpdateRecord

WriteRecord