Fungsi SCardGetDeviceTypeIdA (winscard.h)

  • Artikel

Fungsi SCardGetDeviceTypeId mendapatkan pengidentifikasi jenis perangkat pembaca kartu untuk nama pembaca yang diberikan. Fungsi ini tidak memengaruhi status pembaca.

Sintaks

LONG SCardGetDeviceTypeIdA(
  [in]      SCARDCONTEXT hContext,
  [in]      LPCSTR       szReaderName,
  [in, out] LPDWORD      pdwDeviceTypeId
);

Parameter

[in] hContext

Menangani yang mengidentifikasi konteks resource manager untuk kueri. Anda dapat mengatur konteks manajer sumber daya dengan memanggil fungsi SCardEstablishContext . Parameter ini tidak boleh NULL.

[in] szReaderName

Nama pembaca. Anda bisa mendapatkan nilai ini dengan memanggil fungsi SCardListReaders .

[in, out] pdwDeviceTypeId

Pengidentifikasi jenis perangkat yang sebenarnya. Daftar jenis pembaca yang dikembalikan oleh fungsi ini tercantum di bawah anggota ReaderType dalam struktur SCARD_READER_CAPABILITIES .

Nilai kembali

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

Catatan

Header winscard.h mendefinisikan SCardGetDeviceTypeId 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 8 [khusus aplikasi desktop]
Server minimum yang didukung Windows Server 2012 [hanya aplikasi desktop]
Target Platform Windows
Header winscard.h
DLL Winscard.dll