METODE ISCardISO7816::ReadBinary
[Metode ReadBinary 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 ReadBinary membuat perintah unit data protokol aplikasi (APDU) yang memperoleh pesan respons yang memberikan bagian dari konten file dasar yang terstruktur transparan.
Sintaks
HRESULT ReadBinary(
[in] BYTE byP1,
[in] BYTE byP2,
[in] LONG lBytesToRead,
[in, out] LPSCARDCMD *ppCmd
);
Parameter
-
byP1 [in]
-
Bidang P1-P2, diimbangi ke byte pertama yang akan dibaca dari awal file. 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 akan dibaca dalam unit data dari awal file. Jika b8=0 di P1, maka P1|| P2 adalah offset byte pertama yang dibaca dalam unit data dari awal file.
-
byP2 [in]
-
Bidang P1-P2, diimbangi ke byte pertama yang akan dibaca dari awal file. 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 akan dibaca dalam unit data dari awal file. Jika b8=0 di P1, maka P1|| P2 adalah offset byte pertama yang dibaca dalam unit data dari awal file.
-
lBytesToRead [in]
-
Jumlah byte yang akan dibaca dari EF transparan.
Jika bidang Le hanya berisi nol, maka dalam batas 256 untuk panjang pendek atau 65536 untuk panjang yang diperpanjang, semua byte hingga akhir file harus dibaca.
-
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 menggunakan penunjuk ppCmd.
Nilai kembali
Metode mengembalikan salah satu nilai yang mungkin berikut ini.
Menampilkan kode | Deskripsi |
---|---|
|
Operasi selesai dengan sukses. |
|
Parameter tidak valid. |
|
Penunjuk yang buruk diteruskan. |
|
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.
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 |
|
Pustaka jenis |
|
DLL |
|
IID |
IID_ISCardISO7816 didefinisikan sebagai 53B6AA68-3F56-11D0-916B-00AA00C18068 |
Lihat juga
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk