Fungsi SCardGetStatusChangeA (winscard.h)

Fungsi SCardGetStatusChange memblokir eksekusi hingga ketersediaan kartu saat ini dalam sekumpulan pembaca tertentu berubah.

Penelepon memasok daftar pembaca untuk dipantau oleh array SCARD_READERSTATE dan jumlah waktu maksimum (dalam milidetik) yang bersedia menunggu tindakan terjadi pada salah satu pembaca yang terdaftar. Perhatikan bahwa SCardGetStatusChange menggunakan nilai yang disediakan pengguna di anggota dwCurrentState dari array SCARD_READERSTATE rgReaderStates sebagai definisi status pembaca saat ini. Fungsi ini mengembalikan ketika ada perubahan ketersediaan, setelah mengisi anggota dwEventStatergReaderStates dengan tepat.

Sintaks

LONG SCardGetStatusChangeA(
  [in]      SCARDCONTEXT         hContext,
  [in]      DWORD                dwTimeout,
  [in, out] LPSCARD_READERSTATEA rgReaderStates,
  [in]      DWORD                cReaders
);

Parameter

[in] hContext

Handel yang mengidentifikasi konteks resource manager. Konteks manajer sumber daya diatur oleh panggilan sebelumnya ke fungsi SCardEstablishContext .

[in] dwTimeout

Jumlah waktu maksimum, dalam milidetik, untuk menunggu tindakan. Nilai nol menyebabkan fungsi segera kembali. Nilai INFINITE menyebabkan fungsi ini tidak pernah kehabisan waktu.

[in, out] rgReaderStates

Array struktur SCARD_READERSTATE yang menentukan pembaca untuk watch, dan yang menerima hasilnya.

Untuk diberi tahu tentang kedatangan pembaca kartu pintar baru, atur anggota szReader dari struktur SCARD_READERSTATE ke "\\? PnP?\Notification", dan atur semua anggota lain dari struktur tersebut ke nol.

Penting Setiap anggota dari setiap struktur dalam array ini harus diinisialisasi ke nol lalu diatur ke nilai tertentu seperlunya. Jika ini tidak dilakukan, fungsi akan gagal dalam situasi yang melibatkan pembaca kartu jarak jauh.

 

[in] cReaders

Jumlah elemen dalam array rgReaderStates .

Mengembalikan nilai

Fungsi ini mengembalikan nilai yang berbeda tergantung pada apakah berhasil atau gagal.

Menampilkan kode	Deskripsi
Berhasil	SCARD_S_SUCCESS.
Kegagalan	Kode kesalahan. Untuk informasi selengkapnya, lihat Nilai Pengembalian Kartu Pintar.

Keterangan

Fungsi SCardGetStatusChange adalah fungsi pelacakan kartu pintar . Untuk informasi selengkapnya tentang fungsi pelacakan lainnya, lihat Fungsi Pelacakan Kartu Pintar.

Contoh

Untuk informasi tentang cara memanggil fungsi ini, lihat contoh di SCardLocateCards.

Catatan

Header winscard.h mendefinisikan SCardGetStatusChange sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor 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

Persyaratan	Nilai
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

Lihat juga

SCARD_READERSTATE

SCardCancel

SCardEstablishContext

SCardLocateCards