ISCardISO7816::Metode InternalAuthenticate
[Metode InternalAuthenticate 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 InternalAuthenticate membuat perintah unit data protokol aplikasi (APDU) yang memulai komputasi data autentikasi dengan kartu menggunakan data tantangan yang dikirim dari perangkat antarmuka dan rahasia yang relevan (misalnya, kunci) yang disimpan dalam kartu.
Ketika rahasia yang relevan dilampirkan ke MF, perintah dapat digunakan untuk mengautentikasi kartu secara keseluruhan.
Ketika rahasia yang relevan dilampirkan ke DF lain, perintah dapat digunakan untuk mengautentikasi DF tersebut.
Sintaks
HRESULT InternalAuthenticate(
[in] BYTE byAlgorithmRef,
[in] BYTE bySecretRef,
[in] LPBYTEBUFFER pChallenge,
[in] LONG lReplyBytes,
[in, out] LPSCARDCMD *ppCmd
);
Parameter
-
byAlgorithmRef [in]
-
Referensi algoritma dalam kartu.
Jika nilai ini nol, ini menunjukkan bahwa tidak ada informasi yang diberikan. Referensi algoritma diketahui baik sebelum mengeluarkan perintah atau disediakan di bidang data.
-
bySecretRef [in]
-
Referensi rahasia.
Nilai Makna - Tidak Ada Info
Posisi bit: 00000000
Tidak ada informasi yang diberikan. Referensi rahasia diketahui baik sebelum mengeluarkan perintah atau disediakan di bidang data.- Ref global
Posisi bit: 0-------
Data referensi global (kunci khusus MF).- Ref tertentu
Posisi bit: 1-------
Data referensi tertentu (kunci khusus DF).- RFU
Posisi bit: -xx-----
00 (nilai lainnya adalah RFU).- Rahasia
Posisi bit: ---xxxxxx
Jumlah rahasia. -
pChallenge [in]
-
Arahkan ke data terkait autentikasi (misalnya, tantangan).
-
lReplyBytes [in]
-
Jumlah maksimum byte yang diharapkan sebagai respons.
-
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.
Mengembalikan nilai
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
Keberhasilan eksekusi perintah dapat tunduk pada keberhasilan penyelesaian perintah sebelumnya (misalnya, VERIFIKASI atau PILIH FILE) atau pilihan (misalnya, rahasia yang relevan).
Jika kunci dan algoritma saat ini dipilih saat mengeluarkan perintah, maka perintah dapat secara implisit menggunakan kunci dan algoritma.
Berapa kali perintah dikeluarkan dapat dicatat dalam kartu untuk membatasi jumlah upaya lebih lanjut menggunakan rahasia atau algoritma yang relevan.
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