Fungsi SCardForgetReaderA (winscard.h)
Fungsi SCardForgetReader menghapus pembaca yang diperkenalkan sebelumnya dari kontrol oleh subsistem kartu pintar. Ini dihapus dari database kartu pintar, termasuk dari grup pembaca mana pun yang mungkin telah ditambahkan.
Sintaks
LONG SCardForgetReaderA(
[in] SCARDCONTEXT hContext,
[in] LPCSTR szReaderName
);
Parameter
[in] hContext
Menangani yang mengidentifikasi konteks resource manager. Konteks manajer sumber daya diatur oleh panggilan sebelumnya ke SCardEstablishContext. Parameter ini tidak boleh NULL.
[in] szReaderName
Tampilkan nama pembaca yang akan dihapus dari database kartu pintar.
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
Jika pembaca yang ditentukan adalah anggota terakhir dari grup pembaca, grup pembaca juga akan dihapus secara otomatis.
Fungsi SCardForgetReader adalah fungsi manajemen database. Untuk informasi selengkapnya tentang fungsi manajemen database lainnya, lihat Fungsi Manajemen Database Kartu Pintar.
Contoh
Contoh berikut menghapus nama tampilan pembaca kartu yang ditentukan dari sistem. Contoh mengasumsikan bahwa lReturn adalah variabel tipe LONG yang valid dan hContext adalah handel valid yang diterima dari panggilan sebelumnya ke fungsi SCardEstablishContext .
lReturn = SCardForgetReader(hContext,
TEXT("MyReader"));
if ( SCARD_S_SUCCESS != lReturn )
printf("Failed SCardForgetReader\n");
Catatan
Header winscard.h mendefinisikan SCardForgetReader sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosedur 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 |
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