Fungsi SCardForgetCardTypeA (winscard.h)

Artikel
08/27/2023

Fungsi SCardForgetCardType menghapus kartu pintar yang diperkenalkan dari subsistem kartu pintar.

Sintaks

LONG SCardForgetCardTypeA(
  [in] SCARDCONTEXT hContext,
  [in] LPCSTR       szCardName
);

Parameter

[in] hContext

Menangani yang mengidentifikasi konteks resource manager. Konteks manajer sumber daya diatur oleh panggilan sebelumnya ke SCardEstablishContext. Parameter ini tidak boleh NULL.

[in] szCardName

Nama tampilan kartu yang akan dihapus dari database kartu pintar.

Mengembalikan nilai

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 ini tidak dialihkan, tetapi memanggil fungsi SCardForgetCardType ketika di dalam sesi Desktop Jauh tidak akan mengakibatkan kesalahan. Ini hanya berarti bahwa hasilnya akan berasal dari komputer jarak jauh alih-alih komputer lokal.

Fungsi SCardForgetCardType adalah fungsi manajemen database. Untuk informasi selengkapnya tentang fungsi manajemen database lainnya, lihat Fungsi Manajemen Database Kartu Pintar.

Contoh

Contoh berikut menghapus jenis kartu yang ditentukan dari sistem. Contoh mengasumsikan bahwa lReturn adalah variabel tipe LONG yang valid, bahwa hContext adalah handel valid yang diterima dari panggilan sebelumnya ke fungsi SCardEstablishContext , dan bahwa "MyCardName" sebelumnya diperkenalkan oleh panggilan ke fungsi SCardIntroduceCardType .


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

Catatan

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


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