ISCardISO7816::Metode ExternalAuthenticate

[Metode ExternalAuthenticate 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 ExternalAuthenticate membuat perintah unit data protokol aplikasi (APDU) yang memperbarui status keamanan secara kondisional, memverifikasi identitas komputer ketika kartu pintar tidak mempercayainya.

Perintah menggunakan hasil (ya atau tidak) komputasi oleh kartu (berdasarkan tantangan yang sebelumnya dikeluarkan oleh kartu, misalnya, dengan perintah INS_GET_CHALLENGE), kunci (mungkin rahasia) yang disimpan dalam kartu, dan data autentikasi yang dikirimkan oleh perangkat antarmuka.

Sintaks

HRESULT ExternalAuthenticate(
  [in]      BYTE         byAlgorithmRef,
  [in]      BYTE         bySecretRef,
  [in]      LPBYTEBUFFER pChallenge,
  [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: ---xxxxx Jumlah rahasia.

 

pChallenge [in]

Penunjuk ke data terkait autentikasi. Parameter ini mungkin 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.

Mengembalikan nilai

Metode mengembalikan salah satu nilai yang mungkin berikut ini.

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

 

Keterangan

Agar perintah yang dienkapsulasi berhasil, tantangan terakhir yang diperoleh dari kartu harus valid.

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

InternalAuthenticate

ISCardISO7816