Fungsi SCardForgetReaderGroupW (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 yang dalam database.

Sintaksis

LONG SCardForgetReaderGroupW(
  [in] SCARDCONTEXT hContext,
  [in] LPCWSTR      szGroupName
);

Parameter

[in] hContext

Tangani yang mengidentifikasi konteks resource manager. Konteks resource manager diatur oleh panggilan sebelumnya ke SCardEstablishContext. Parameter ini tidak dapat null.

[in] szGroupName

Tampilkan nama grup pembaca yang akan dihapus. Grup pembaca yang ditentukan sistem tidak dapat dihapus dari database.

Nilai	Arti
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 saat 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.

Mengembalikan nilai

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

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

Komentar

Fungsi SCardForgetReaderGroup adalah fungsi manajemen database. Untuk informasi selengkapnya tentang fungsi manajemen database lainnya, lihat Smart Card Database Management Functions.

Contoh

Contoh berikut menunjukkan cara menghapus grup pembaca dari sistem. Contoh mengasumsikan bahwa lReturn adalah variabel jenis yang ada LONG, dan hContext tersebut adalah handel yang valid ke konteks resource manager yang sebelumnya diperoleh dari panggilan ke fungsi SCardEstablishContext.

lReturn = SCardForgetReaderGroup(hContext, 
                                 L"MyReaderGroup");
if ( SCARD_S_SUCCESS != lReturn )
    printf("Failed SCardForgetReaderGroup\n");

Nota

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

Syarat	Nilai
klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Platform Target	Windows
Header	winscard.h
Pustaka	Winscard.lib
DLL	Winscard.dll

Lihat juga

SCardEstablishContext

SCardForgetCardType

SCardForgetReader

SCardIntroduceReaderGroup