Fungsi SCardReconnect (winscard.h)

  • Artikel

Fungsi SCardReconnect membangun kembali koneksi yang ada antara aplikasi panggilan dan kartu pintar. Fungsi ini memindahkan handel kartu dari akses langsung ke akses umum, atau mengakui dan menghapus kondisi kesalahan yang mencegah akses lebih lanjut ke kartu.

Sintaks

LONG SCardReconnect(
  [in]            SCARDHANDLE hCard,
  [in]            DWORD       dwShareMode,
  [in]            DWORD       dwPreferredProtocols,
  [in]            DWORD       dwInitialization,
  [out, optional] LPDWORD     pdwActiveProtocol
);

Parameter

[in] hCard

Nilai referensi yang diperoleh dari panggilan sebelumnya ke SCardConnect.

[in] dwShareMode

Bendera yang menunjukkan apakah aplikasi lain mungkin membentuk koneksi ke kartu ini.

Nilai Makna
SCARD_SHARE_SHARED
 Aplikasi ini akan berbagi kartu ini dengan aplikasi lain.
SCARD_SHARE_EXCLUSIVE
 Aplikasi ini tidak akan berbagi kartu ini dengan aplikasi lain.

[in] dwPreferredProtocols

Bitmask dari protokol yang dapat diterima untuk sambungan ini. Nilai yang mungkin digabungkan dengan operasi OR .

Nilai parameter ini harus menyertakan protokol saat ini. Mencoba menyambung kembali dengan protokol selain protokol saat ini akan mengakibatkan kesalahan.

Nilai Makna
SCARD_PROTOCOL_T0
 T=0 adalah protokol yang dapat diterima.
SCARD_PROTOCOL_T1
 T=1 adalah protokol yang dapat diterima.

[in] dwInitialization

Jenis inisialisasi yang harus dilakukan pada kartu.

Nilai Makna
SCARD_LEAVE_CARD
 Jangan melakukan sesuatu yang istimewa saat menyambungkan kembali.
SCARD_RESET_CARD
 Reset kartu (Warm Reset).
SCARD_UNPOWER_CARD
 Matikan kartu dan reset (Cold Reset).

[out, optional] pdwActiveProtocol

Bendera yang menunjukkan protokol aktif yang ditetapkan.

Nilai Makna
SCARD_PROTOCOL_T0
 T=0 adalah protokol aktif.
SCARD_PROTOCOL_T1
 T=1 adalah protokol aktif.

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

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

Contoh

Contoh berikut menunjukkan membangun kembali koneksi.

DWORD     dwAP;
LONG      lReturn;

// Reconnect.
// hCardHandle was set by a previous call to SCardConnect.
lReturn = SCardReconnect(hCardHandle,
                         SCARD_SHARE_SHARED,
                         SCARD_PROTOCOL_T0 | SCARD_PROTOCOL_T1,
                         SCARD_LEAVE_CARD,
                         &dwAP );
if ( SCARD_S_SUCCESS != lReturn )
    printf("Failed SCardReconnect\n");

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

Lihat juga

SCardConnect

SCardDisconnect