Metode ISCardISO7816::UpdateRecord

Artikel
06/13/2023

[Metode UpdateRecord 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 UpdateRecord membuat perintah unit data protokol aplikasi (APDU) yang memperbarui rekaman tertentu dengan bit yang diberikan dalam perintah APDU.

Catatan

Saat menggunakan alamat rekaman saat ini, perintah mengatur penunjuk rekaman pada rekaman yang berhasil diperbarui.

Sintaks

HRESULT UpdateRecord(
  [in]      BYTE         byRecordId,
  [in]      BYTE         byRefCtrl,
  [in]      LPBYTEBUFFER pData,
  [in, out] LPSCARDCMD   *ppCmd
);

Parameter

byRecordId [in]

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
Record # in P1	Posisi bit: -----100

pData [in]

Penunjuk ke rekaman yang akan diperbarui.

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
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 elementary pendek yang valid, perintah mengatur file sebagai file elementary 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 dibuat berlaku untuk file elementary linear-fixed atau cyclic-structured, perintah tersebut akan dibatalkan jika panjang rekaman berbeda dari panjang rekaman yang ada.

Jika perintah berlaku untuk file elementary terstruktur variabel linier, perintah dapat dilakukan ketika panjang rekaman berbeda dari panjang rekaman yang ada.

Opsi "sebelumnya" dari perintah (P2=xxxxxx011), diterapkan ke file siklik, memiliki perilaku yang sama dengan perintah yang dibangun oleh AppendRecord.

File dasar tanpa struktur rekaman tidak dapat dibaca. Perintah yang dibangun membatalkan jika diterapkan ke file elementary 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
ReadRecord
WriteRecord

Bagikan melalui