ISCardISO7816::Metode WriteBinary

[Metode WriteBinary 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 WriteBinary membuat perintah unit data protokol aplikasi (APDU) yang menulis nilai biner ke dalam file dasar.

Bergantung pada atribut file, perintah melakukan salah satu operasi berikut:

  • OR logis bit yang sudah ada dalam kartu dengan bit yang diberikan dalam perintah APDU (status logis yang dihapus dari bit file adalah 0).
  • AND logis dari bit yang sudah ada dalam kartu dengan bit yang diberikan dalam perintah APDU (status logis yang dihapus dari bit file adalah 1).
  • Penulisan satu kali dalam kartu bit yang diberikan dalam perintah APDU.

Ketika tidak ada indikasi yang diberikan dalam byte pengkodean data, perilaku LOGIS ATAU berlaku.

Sintaks

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

Parameter

byP1 [in]

Offset ke lokasi tulis dari awal file biner (EF). Jika b8=1 dalam P1, maka b7 dan b6 dari P1 diatur ke nol (bit RFU), b5 hingga b1 dari P1 adalah pengidentifikasi EF pendek dan P2 adalah offset byte pertama yang ditulis dalam unit data dari awal file. Jika b8=0 dalam P1, maka P1|| P2 adalah offset byte pertama yang ditulis dalam unit data dari awal file.

byP2 [in]

Offset ke lokasi tulis dari awal file biner (EF). Jika b8=1 dalam P1, maka b7 dan b6 dari P1 diatur ke nol (bit RFU), b5 hingga b1 dari P1 adalah pengidentifikasi EF pendek dan P2 adalah offset byte pertama yang ditulis dalam unit data dari awal file. Jika b8=0 dalam P1, maka P1|| P2 adalah offset byte pertama yang ditulis dalam unit data dari awal file.

pData [in]

Arahkan ke string unit data yang akan ditulis.

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 cardISCardCmdpintar dibuat secara internal dan dikembalikan melalui penunjuk ppCmd.

Nilai kembali

Metode mengembalikan salah satu nilai yang mungkin berikut ini.

Mengembalikan kode Deskripsi
S_OK
Operasi selesai dengan sukses.
E_INVALIDARG
Parameter tidak valid.
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 dasar pendek yang valid, perintah menetapkan file sebagai file dasar saat ini.

Ketika operasi biner tulis telah diterapkan ke unit data dari EF tulis satu kali, operasi penulisan lebih lanjut yang mengacu pada unit data ini akan dibatalkan jika konten unit data atau indikator status terhapus logis (jika ada) yang dilampirkan ke unit data ini berbeda dari status terhapus logis.

File dasar tanpa struktur transparan tidak dapat ditulis. 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 [khusus 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

EraseBinary

ISCardISO7816

ReadBinary

UpdateBinary