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 |
|---|---|
|
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 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 |
|
| Typbibliothek |
|
| DLL |
|
| IID |
IID _ ISCardISO7816 ist als 53B6AA68-3F56-11D0-916B-00AA00C18068 definiert. |