Fungsi SCardLocateCardsByATRA (winscard.h)
Fungsi SCardLocateCardsByATR mencari pembaca yang tercantum dalam parameter rgReaderStates untuk kartu dengan nama yang cocok dengan salah satu nama kartu yang terkandung dalam salah satu struktur SCARD_ATRMASK yang ditentukan oleh parameter rgAtrMasks .
Sintaks
LONG SCardLocateCardsByATRA(
[in] SCARDCONTEXT hContext,
[in] LPSCARD_ATRMASK rgAtrMasks,
[in] DWORD cAtrs,
[in, out] LPSCARD_READERSTATEA rgReaderStates,
[in] DWORD cReaders
);
Parameter
[in] hContext
Menangani yang mengidentifikasi konteks resource manager. Konteks resource manager diatur oleh panggilan sebelumnya ke SCardEstablishContext.
[in] rgAtrMasks
Array struktur SCARD_ATRMASK yang berisi nama kartu yang akan dicari.
[in] cAtrs
Jumlah elemen dalam array rgAtrMasks .
[in, out] rgReaderStates
Array struktur SCARD_READERSTATE yang menentukan pembaca untuk dicari, dan menerima hasilnya.
[in] cReaders
Jumlah elemen dalam array rgReaderStates .
Mengembalikan nilai
Fungsi ini mengembalikan nilai yang berbeda tergantung pada apakah berhasil atau gagal.
Menampilkan kode | Deskripsi |
---|---|
|
SCARD_S_SUCCESS. |
|
Kode Kesalahan. Untuk informasi selengkapnya, lihat Nilai Pengembalian Kartu Pintar. |
Keterangan
Layanan ini sangat berguna ketika digunakan bersama dengan SCardGetStatusChange. Jika tidak ada kartu yang cocok yang ditemukan melalui SCardLocateCards, aplikasi panggilan dapat menggunakan SCardGetStatusChange untuk menunggu perubahan ketersediaan kartu.
Fungsi SCardLocateCardsByATR adalah fungsi pelacakan kartu pintar . Untuk informasi tentang fungsi pelacakan lainnya, lihat Fungsi Pelacakan Kartu Pintar.
Catatan
Header winscard.h mendefinisikan SCardLocateCardsByATR sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta praprosedur UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.
Persyaratan
Klien minimum yang didukung | Windows XP [hanya aplikasi desktop] |
Server minimum yang didukung | Windows Server 2003 [hanya aplikasi desktop] |
Target Platform | Windows |
Header | winscard.h |
Pustaka | Winscard.lib |
DLL | Winscard.dll |
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