ISCardISO7816::EraseBinary-Methode

[Die EraseBinary-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 EraseBinary-Methode erstellt einen APDU-Befehl (Application Protocol Data Unit), der einen Teil des Inhalts einer elementaren Datei ab einem angegebenen Offset sequenziell in seinen logischen gelöschten Zustand einordnt.

Syntax

HRESULT EraseBinary(
  [in]      BYTE         byP1,
  [in]      BYTE         byP2,
  [in]      LPBYTEBUFFER pData,
  [in, out] LPSCARDCMD   *ppCmd
);

Parameter

byP1 [ In]

RFU-Position.

Wenn b8=1 in P1, dann sind b7 und b6 von P1 auf 0 (RFU-Bits) festgelegt, b5 bis b1 von P1 sind ein kurzer EF-Bezeichner, und P2 ist der Offset des ersten Byte, das (in Dateneinheiten) vom Anfang der Datei gelöscht werden soll.

Wenn b8=0 in P1, dann ist P1 P2 der Offset des ersten Byte, das (in Dateneinheiten) vom Anfang der Datei | | gelöscht werden soll.

Wenn das Datenfeld vorhanden ist, wird der Offset der ersten Dateneinheit, die nicht gelöscht werden soll, mit codesiert. Dieser Offset muss höher sein als der in P1-P2 codierte Offset. Wenn das Datenfeld leer ist, wird der Befehl bis zum Ende der Datei gelöscht.

byP2 [ In]

RFU-Position.

Wenn b8=1 in P1, dann sind b7 und b6 von P1 auf 0 (RFU-Bits) festgelegt, b5 bis b1 von P1 sind ein kurzer EF-Bezeichner, und P2 ist der Offset des ersten Byte, das (in Dateneinheiten) vom Anfang der Datei gelöscht werden soll.

Wenn b8=0 in P1, dann ist P1 P2 der Offset des ersten Byte, das (in Dateneinheiten) vom Anfang der Datei | | gelöscht werden soll.

Wenn das Datenfeld vorhanden ist, wird der Offset der ersten Dateneinheit, die nicht gelöscht werden soll, mit codesiert. Dieser Offset muss höher sein als der in P1-P2 codierte Offset. Wenn das Datenfeld leer ist, wird der Befehl bis zum Ende der Datei gelöscht.

pData [ In]

Ein Zeiger auf die Daten, die den Löschbereich angibt. Dieser Parameter kann NULL sein.

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
Der Vorgang wurde erfolgreich abgeschlossen.
E _ INVALIDARG
Ein ungültiger Parameter wurde übergeben.
_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 die Sicherheitsattribute der elementaren Datei erfüllt, die verarbeitet wird.

Wenn der Befehl einen gültigen kurzen elementaren Bezeichner enthält, legt er die Datei als aktuelle elementare Datei fest.

Elementare Dateien ohne eine transparente Struktur können nicht gelöscht werden. Der gekapselte Befehl wird abgebrochen, wenn er auf eine elementare Datei ohne transparente Struktur 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

ReadBinary

UpdateBinary

WriteBinary