ISCardISO7816::Verifikasi metode

Artikel
06/13/2023

[Metode Verifikasi 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 Verifikasi membuat perintah unit data protokol aplikasi (APDU) yang memulai perbandingan (dalam kartu) data verifikasi yang dikirim dari perangkat antarmuka dengan data referensi yang disimpan dalam kartu (misalnya, kata sandi).

Sintaks

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

Parameter

byRefCtrl [in]

Kuantifier data referensi. Pengkodian kontrol referensi P2 mengikuti.

Ketika isi kosong, perintah dapat digunakan baik untuk mengambil angka 'X' dari percobaan ulang yang diizinkan lebih lanjut (SW1-SW2=63CX) atau untuk memeriksa apakah verifikasi tidak diperlukan (SW1-SW2=9000).

Nilai	Makna
Tidak Ada Info	Posisi bit: 00000000 P2=00 dicadangkan untuk menunjukkan bahwa tidak ada kualifikasi tertentu yang digunakan dalam kartu tersebut di mana perintah verifikasi mereferensikan data rahasia secara tidak ambigu.
Global Ref	Posisi bit: 0------- Contoh Ref Global adalah kata sandi.
Ref Tertentu	Posisi bit: 1------- Contoh Ref Tertentu adalah kata sandi khusus DF.
RFU	Posisi bit: -xx-----
Ref Data #	Posisi bit: ---xxxxxx Nomor data referensi mungkin, misalnya, nomor kata sandi atau pengidentifikasi EF singkat.

pData [in]

Penunjuk ke data verifikasi. Parameter ini bisa NULL. Nilai defaultnya adalah NULL.

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 dengan menggunakan penunjuk ppCmd.

Nilai kembali

Metode mengembalikan salah satu nilai yang mungkin berikut ini.

Menampilkan kode	Deskripsi
S_OK	Operasi berhasil diselesaikan.
E_INVALIDARG	Parameter yang tidak valid digunakan.
E_POINTER	Penunjuk yang buruk diteruskan.
E_OUTOFMEMORY	Kehabisan memori.

Keterangan

Status keamanan dapat dimodifikasi sebagai akibat dari perbandingan. Perbandingan yang gagal dapat dicatat dalam kartu (misalnya, untuk membatasi jumlah upaya lebih lanjut dari penggunaan data referensi).

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

ISCardISO7816

Share via