ISCardISO7816::AppendRecord-Methode

Artikel
06/13/2023

[Die AppendRecord-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 AppendRecord-Methode erstellt einen APDU-Befehl ( Application Protocol Data Unit ), der entweder einen Datensatz an das Ende einer linear strukturierten Elementardatei (EF) anhängt oder Datensatz 1 in eine zyklische, strukturierte Elementardatei schreibt.

Syntax

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

Parameter

byRefCtrl [in]

Gibt die elementare Datei an, die angefügt werden soll.

Wert	Bedeutung
Aktuelle EF	Bitposition: 00000000
Kurze EF-ID	Bitposition: xxxxx000
Reserved	Bitposition: xxxxxxxxxx

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
data	Ln 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 intelligentes KarteISCardCmd-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_POINTER	Ein ungültiger Zeiger wurde übergeben.
E_OUTOFMEMORY	Nicht genügend Arbeitsspeicher.

Bemerkungen

Der gekapselte Befehl kann nur ausgeführt werden, wenn der sicherheitsrelevante status des intelligenten Karte die Sicherheitsattribute der gelesenen Elementardatei erfüllt.

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.

Elementardateien ohne Datensatzstruktur können nicht gelesen werden. Der gekapselte Befehl bricht ab, wenn er auf eine Elementardatei ohne Datensatzstruktur angewendet wird.

Eine Liste aller Methoden, die von dieser Schnittstelle bereitgestellt werden, finden Sie unter ISCardISO7816.

Zusätzlich zu den oben aufgeführten COM-Fehlercodes gibt diese Schnittstelle möglicherweise einen Fehlercode für intelligente Karte zurück, wenn eine intelligente 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

ISCardISO7816
ReadRecord
UpdateRecord
WriteRecord

Freigeben über