Fungsi SCardForgetReaderGroupA (winscard.h)
Fungsi SCardForgetReaderGroup menghapus grup pembacakartu pintar yang diperkenalkan sebelumnya dari subsistem kartu pintar. Meskipun fungsi ini secara otomatis menghapus semua pembaca dari grup, fungsi ini tidak memengaruhi keberadaan pembaca individu dalam database.
Sintaks
LONG SCardForgetReaderGroupA(
[in] SCARDCONTEXT hContext,
[in] LPCSTR szGroupName
);
Parameter
[in] hContext
Menangani yang mengidentifikasi konteks resource manager. Konteks resource manager diatur oleh panggilan sebelumnya ke SCardEstablishContext. Parameter ini tidak boleh NULL.
[in] szGroupName
Nama tampilan grup pembaca yang akan dihapus. Grup pembaca yang ditentukan sistem tidak dapat dihapus dari database.
Nilai kembali
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
Fungsi SCardForgetReaderGroup adalah fungsi manajemen database. Untuk informasi selengkapnya tentang fungsi manajemen database lainnya, lihat Fungsi Manajemen Database Kartu Pintar.
Contoh
Contoh berikut menunjukkan cara menghapus grup pembaca dari sistem. Contoh mengasumsikan bahwa lReturn adalah variabel jenis LONG yang ada, dan hContext tersebut adalah handel yang valid untuk konteks manajer sumber daya yang sebelumnya diperoleh dari panggilan ke fungsi SCardEstablishContext .
lReturn = SCardForgetReaderGroup(hContext,
L"MyReaderGroup");
if ( SCARD_S_SUCCESS != lReturn )
printf("Failed SCardForgetReaderGroup\n");
Catatan
Header winscard.h mendefinisikan SCardForgetReaderGroup 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
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
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