Metode ISCardISO7816::EraseBinary

Artikel
06/13/2023

[Metode EraseBinary tersedia untuk digunakan dalam sistem operasi yang ditentukan di bagian Persyaratan. Ini tidak tersedia untuk digunakan di Windows Server 2003 dengan Paket Layanan 1 (SP1) dan yang lebih baru, Windows Vista, Windows Server 2008, dan versi sistem operasi berikutnya. Modul Kartu Pintar menyediakan fungsionalitas serupa.]

Metode EraseBinary membangun perintah unit data protokol aplikasi (APDU) yang secara berurutan menetapkan bagian dari konten file dasar ke status dihapus logisnya, mulai dari offset tertentu.

Sintaks

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

Parameter

byP1 [in]

Posisi RFU.

Jika b8=1 dalam P1, maka b7 dan b6 dari P1 diatur ke nol (bit RFU), b5 ke b1 dari P1 adalah pengidentifikasi EF singkat dan P2 adalah offset byte pertama yang akan dihapus (dalam unit data) dari awal file.

Jika b8=0 di P1, maka P1 || P2 adalah offset byte pertama yang akan dihapus (dalam unit data) dari awal file.

Jika bidang data ada, bidang tersebut mengkodekan offset unit data pertama yang tidak akan dihapus. Offset ini akan lebih tinggi dari yang dikodekan dalam P1-P2. Saat bidang data kosong, perintah akan menghapus hingga akhir file.

byP2 [in]

Posisi RFU.

Jika b8=0 di P1, maka P1 || P2 adalah offset byte pertama yang akan dihapus (dalam unit data) dari awal file.

pData [in]

Penunjuk ke data yang menentukan rentang penghapusan. Parameter ini mungkin NULL.

ppCmd [masuk, keluar]

Pada input, penunjuk ke objek antarmuka ISCardCmd atau NULL.

Saat dikembalikan, perintah ini diisi dengan perintah APDU yang dibangun oleh operasi ini. Jika ppCmd diatur ke NULL, objek ISCardCmdkartu pintar dibuat secara internal dan dikembalikan dengan menggunakan penunjuk ppCmd.

Mengembalikan nilai

Metode mengembalikan salah satu nilai yang mungkin berikut ini.

Menampilkan kode	Deskripsi
S_OK	Operasi berhasil diselesaikan.
E_INVALIDARG	Parameter yang tidak valid telah diteruskan.
E_POINTER	Penunjuk yang buruk diteruskan.
E_OUTOFMEMORY	Kehabisan memori.

Keterangan

Perintah yang dienkapsulasi hanya dapat dilakukan jika status keamanan kartu pintar memenuhi atribut keamanan file dasar yang sedang diproses.

Ketika perintah berisi pengidentifikasi elementary pendek yang valid, perintah mengatur file sebagai file elementary saat ini.

File dasar tanpa struktur transparan tidak dapat dihapus. Perintah yang dienkapsulasi membatalkan jika diterapkan ke file dasar tanpa struktur transparan.

Untuk daftar semua metode yang disediakan oleh antarmuka ini, lihat ISCardISO7816.

Selain kode kesalahan COM yang tercantum di atas, antarmuka ini dapat mengembalikan kode kesalahan kartu pintar jika fungsi kartu pintar dipanggil untuk menyelesaikan permintaan. Untuk informasi selengkapnya, lihat Nilai Pengembalian Kartu Pintar.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Akhir dukungan klien	Windows XP
Akhir dukungan server	Windows Server 2003
Header	Scardssp.h
Pustaka jenis	Scardsrv.tlb
DLL	Scardssp.dll
IID	IID_ISCardISO7816 didefinisikan sebagai 53B6AA68-3F56-11D0-916B-00AA00C18068

Lihat juga

ISCardISO7816
ReadBinary
UpdateBinary
WriteBinary