Baca dalam bahasa Inggris

Bagikan melalui

Fungsi SCardForgetReaderA (winscard.h)

  • Artikel

Fungsi SCardForgetReader menghapus pembaca yang diperkenalkan sebelumnya dari kontrol oleh subsistem kartu pintar . Ini dihapus daridatabase kartu pintar , termasuk dari grup pembaca yang mungkin telah ditambahkan.

Sintaksis

LONG SCardForgetReaderA(
  [in] SCARDCONTEXT hContext,
  [in] LPCSTR       szReaderName
);

Parameter

[in] hContext

Tangani yang mengidentifikasi konteks resource manager. Konteks resource manager diatur oleh panggilan sebelumnya ke SCardEstablishContext. Parameter ini tidak dapat 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.

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

Komentar

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 Smart Card Database Management Functions.

Contoh

Contoh berikut menghapus nama tampilan pembaca kartu yang ditentukan dari sistem. Contoh mengasumsikan bahwa lReturn adalah variabel tipe yang valid LONG 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

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

SCardForgetReaderGroup

SCardIntroduceReader