ISCardISO7816::EraseBinary-Methode

Artikel
06/13/2023

[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 sequenziell auf ihren logischen gelöschten Zustand festlegt, beginnend mit einem bestimmten Offset.

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 werden b7 und b6 von P1 auf Null (RFU-Bits) festgelegt, b5 bis b1 von P1 sind ein kurzer EF-Bezeichner und P2 der Offset des ersten Byte, das (in Dateneinheiten) vom Anfang der Datei gelöscht werden soll.

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

Wenn das Datenfeld vorhanden ist, codiert es den Offset der ersten Dateneinheit, die nicht gelöscht werden soll. 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=0 in P1, dann P1 || P2 ist der Offset des ersten Byte, das (in Dateneinheiten) vom Anfang der Datei gelöscht werden soll.

pData [in]

Ein Zeiger auf die Daten, der 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 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	Der Vorgang wurde erfolgreich abgeschlossen.
E_INVALIDARG	Ein ungültiger Parameter wurde übergeben.
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 verarbeitenden Elementardatei erfüllt.

Wenn der Befehl einen gültigen kurzen elementaren Bezeichner enthält, wird die Datei als aktuelle Elementardatei festgelegt.

Elementardateien ohne 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 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

ISCardISO7816
ReadBinary
UpdateBinary
WriteBinary

Freigeben über