Metode ISCardISO7816::ReadRecord

Artikel
06/13/2023

[Metode ReadRecord 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 ReadRecord membuat perintah unit data protokol aplikasi (APDU) yang membaca konten rekaman yang ditentukan atau bagian awal dari satu rekaman file dasar.

Sintaks

HRESULT ReadRecord(
  [in]      BYTE       byRecordId,
  [in]      BYTE       byRefCtrl,
  [in]      LONG       lBytesToRead,
  [in, out] LPSCARDCMD *ppCmd
);

Parameter

byRecordId [in]

Nomor rekaman atau ID rekaman pertama yang akan dibaca (00 menunjukkan rekaman saat ini).

byRefCtrl [in]

Pengkodian kontrol referensi.

Nilai	Makna
EF Saat Ini	Posisi bit: 00000--- EF yang saat ini dipilih.
ID EF pendek	Posisi bit: xxxxx--- Pengidentifikasi EF pendek.
RFU	Posisi bit: 11111---
Catatan #	Posisi bit: -----1xx Penggunaan nomor rekaman di P1.
Baca Rekaman	Posisi bit: -----100 Membaca rekaman P1.
Hingga Terakhir	Posisi bit: -----101 Membaca semua rekaman dari P1 hingga yang terakhir.
Hingga P1	Posisi bit: -----110 Baca semua rekaman dari yang terakhir hingga P1.
RFU	Posisi bit: -----111
ID Rekaman	Posisi bit: -----0xx Penggunaan nomor rekaman di P1.
Pertama Terjadi	Posisi bit: -----000 Baca kemunculan pertama.
Terakhir Terjadi	Posisi bit: -----001 Baca kemunculan terakhir.
Berikutnya Terjadi	Posisi bit: -----010 Baca kemunculan berikutnya.
Sebelumnya	Posisi bit: -----011 Baca kemunculan sebelumnya.
Rahasia	Posisi bit: ---xxxxxx

lBytesToRead [in]

Jumlah byte yang akan dibaca dari EF transparan.

Jika bidang Le hanya berisi nol, maka tergantung pada b3b2b1 P2 dan dalam batas 256 untuk panjang pendek atau 65536 untuk panjang yang diperpanjang, perintah harus membaca sepenuhnya baik satu rekaman yang diminta atau urutan rekaman yang diminta.

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 melalui penunjuk ppCmd.

Menampilkan nilai

Metode mengembalikan salah satu nilai yang mungkin berikut ini.

Menampilkan 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 dibaca.

Jika file elementary lain saat ini dipilih pada saat mengeluarkan perintah ini, file tersebut dapat diproses tanpa identifikasi file yang saat ini dipilih.

Ketika perintah berisi pengidentifikasi dasar pendek yang valid, perintah menetapkan file sebagai file dasar saat ini.

File dasar tanpa struktur rekaman tidak dapat dibaca. Perintah yang dienkapsulasi membatalkan jika diterapkan ke file dasar tanpa struktur rekaman.

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

AppendRecord
ISCardISO7816
UpdateRecord
WriteRecord

Share via