Fungsi SCardIntroduceReaderGroupA (winscard.h)

Artikel
03/08/2023

Fungsi SCardIntroduceReaderGroup memperkenalkan grup pembaca ke subsistem kartu pintar . Namun, grup pembaca tidak dibuat sampai grup ditentukan saat menambahkan pembaca ke database kartu pintar.

Sintaks

LONG SCardIntroduceReaderGroupA(
  [in] SCARDCONTEXT hContext,
  [in] LPCSTR       szGroupName
);

Parameter

[in] hContext

Menyediakan handel yang mengidentifikasi konteks resource manager. Konteks resource manager diatur oleh panggilan sebelumnya ke fungsi SCardEstablishContext . Jika parameter ini NULL, cakupan manajer sumber daya SCARD_SCOPE_SYSTEM.

[in] szGroupName

Menyediakan nama tampilan yang akan ditetapkan ke grup pembaca baru.

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 SCardIntroduceReaderGroup disediakan untuk kompatibilitas spesifikasi PC/SC. Grup pembaca tidak disimpan sampai pembaca ditambahkan ke grup.

Fungsi SCardIntroduceReaderGroup adalah fungsi manajemen database. Untuk deskripsi fungsi manajemen database lainnya, lihat Fungsi Manajemen Database Kartu Pintar.

Untuk menghapus grup pembaca, gunakan SCardForgetReaderGroup.

Contoh

Contoh berikut menunjukkan memperkenalkan grup pembaca kartu pintar.

// Introduce the reader group.
// lReturn is of type LONG.
// hContext was set by a previous call to SCardEstablishContext.
lReturn = SCardIntroduceReaderGroup(hContext, 
                                    L"MyReaderGroup");
if ( SCARD_S_SUCCESS != lReturn )
    printf("Failed SCardIntroduceReaderGroup\n");

Catatan

Header winscard.h mendefinisikan SCardIntroduceReaderGroup 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 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