Metode ISCardISO7816::WriteRecord
[Metode WriteRecord 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 WriteRecord membuat perintah unit data protokol aplikasi (APDU) yang memulai salah satu operasi berikut:
- Penulisan sekali dari rekaman.
- OR logis dari byte data dari rekaman yang sudah ada di kartu dengan byte data rekaman yang diberikan dalam perintah APDU.
- AND logis dari byte data dari rekaman yang sudah ada di kartu dengan byte data rekaman yang diberikan dalam perintah APDU.
Ketika tidak ada indikasi yang diberikan dalam byte pengkodean data, perilaku LOGIS ATAU berlaku.
Catatan
Saat menggunakan pengalamatan rekaman saat ini, perintah mengatur penunjuk catatan pada rekaman yang berhasil diperbarui.
Sintaks
HRESULT WriteRecord(
[in] BYTE byRecordId,
[in] BYTE byRefCtrl,
[in] LPBYTEBUFFER pData,
[in, out] LPSCARDCMD *ppCmd
);
Parameter
-
byRecordId [in]
-
Rekam identifikasi. Ini adalah nilai P1:
P1 = '00' menunjuk rekaman saat ini.
P1 != '00' adalah jumlah rekaman yang ditentukan.
-
byRefCtrl [in]
-
Pengkodian kontrol referensi P2.
Nilai Makna - EF Saat Ini
Posisi bit: 00000---
EF yang saat ini dipilih.- ID EF pendek
Posisi bit: xxxxx---
Pengidentifikasi EF pendek.- Rekaman Pertama
Posisi bit: -----000 - Rekaman Terakhir
Posisi bit: -----001 - Rekaman Berikutnya
Posisi bit: -----010 - Rekaman Sebelumnya
Posisi bit: -----011 - Rekam # dalam P1
Posisi bit: -----100 -
pData [in]
-
Arahkan ke rekaman 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 ISCardCmdkartu pintar dibuat secara internal dan dikembalikan melalui 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. Jika file elementary lain saat ini dipilih pada saat mengeluarkan perintah ini, perintah ini dapat diproses tanpa identifikasi file yang saat ini dipilih.
Jika perintah yang dienkapsulasi berlaku untuk file elementary linear-fixed atau cyclic-structured, itu akan membatalkan jika panjang rekaman berbeda dari panjang rekaman yang ada. Jika berlaku untuk file dasar terstruktur variabel linier, itu dapat dilakukan ketika panjang rekaman berbeda dari panjang rekaman yang ada.
Jika P2=xxxxx011 dan file elementary adalah file siklik, perintah ini memiliki perilaku yang sama dengan perintah yang dibangun menggunakan AppendRecord.
File dasar tanpa struktur rekaman tidak dapat ditulis. Perintah yang dibuat 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 |
|
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