Fungsi SCardDisconnect (winscard.h)

  • Artikel

Fungsi SCardDisconnect mengakhiri koneksi yang sebelumnya dibuka antara aplikasi panggilan dan kartu pintar di pembaca target.

Sintaks

LONG SCardDisconnect(
  [in] SCARDHANDLE hCard,
  [in] DWORD       dwDisposition
);

Parameter

[in] hCard

Nilai referensi yang diperoleh dari panggilan sebelumnya ke SCardConnect.

[in] dwDisposition

Tindakan untuk mengambil kartu di pembaca yang terhubung saat ditutup.

Nilai Makna
SCARD_LEAVE_CARD
 Jangan lakukan sesuatu yang istimewa.
SCARD_RESET_CARD
 Reset kartu.
SCARD_UNPOWER_CARD
 Matikan kartunya.
SCARD_EJECT_CARD
 Keluarkan kartunya.

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

Jika aplikasi (yang sebelumnya disebut SCardConnect) keluar tanpa memanggil SCardDisconnect, kartu akan direset secara otomatis.

Fungsi SCardDisconnect adalah kartu pintar dan fungsi akses pembaca . Untuk informasi selengkapnya tentang fungsi akses lainnya, lihat Kartu Pintar dan Fungsi Akses Pembaca.

Contoh

Contoh berikut mengakhiri koneksi kartu pintar yang ditentukan. Contoh mengasumsikan bahwa lReturn adalah variabel jenis LONG, dan bahwa hCardHandle adalah handel valid yang diterima dari panggilan sebelumnya ke SCardConnect.


lReturn = SCardDisconnect(hCardHandle, 
                          SCARD_LEAVE_CARD);
if ( SCARD_S_SUCCESS != lReturn )
{
    printf("Failed SCardDisconnect\n");
    exit(1);  // Or other appropriate action.
}

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

Lihat juga

SCardConnect

SCardReconnect