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	Makna
SCARD_ALL_READERS TEXT("SCard$AllReaders\000")	Grup yang digunakan saat tidak ada nama grup yang disediakan saat mencantumkan pembaca. Mengembalikan daftar semua pembaca, terlepas dari grup atau grup tempat pembaca berada.
SCARD_DEFAULT_READERS TEXT("SCard$DefaultReaders\000")	Grup default tempat semua pembaca ditambahkan ketika diperkenalkan ke dalam sistem.
SCARD_LOCAL_READERS TEXT("SCard$LocalReaders\000")	Nilai warisan yang tidak digunakan. Ini adalah grup yang dikelola secara internal yang tidak dapat dimodifikasi dengan menggunakan API grup pembaca apa pun. Ini dimaksudkan untuk digunakan hanya untuk enumerasi.
SCARD_SYSTEM_READERS TEXT("SCard$SystemReaders\000")	Nilai warisan yang tidak digunakan. Ini adalah grup yang dikelola secara internal yang tidak dapat dimodifikasi dengan menggunakan API grup pembaca apa pun. Ini dimaksudkan untuk digunakan hanya untuk enumerasi.

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

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

SCardEstablishContext

SCardForgetCardType

SCardForgetReader

SCardIntroduceReaderGroup