Fungsi SCardBeginTransaction (winscard.h)

  • Artikel

Fungsi SCardBeginTransaction memulai transaksi.

Fungsi menunggu penyelesaian semua transaksi lainnya sebelum dimulai. Setelah transaksi dimulai, semua aplikasi lain diblokir untuk mengakses kartu pintar saat transaksi sedang berlangsung.

Sintaks

LONG SCardBeginTransaction(
  [in] SCARDHANDLE hCard
);

Parameter

[in] hCard

Nilai referensi yang diperoleh dari panggilan sebelumnya ke SCardConnect.

Nilai kembali

Jika fungsi berhasil, fungsi akan mengembalikan SCARD_S_SUCCESS.

Jika fungsi gagal, fungsi akan mengembalikan kode kesalahan. Untuk informasi selengkapnya, lihat Nilai Pengembalian Kartu Pintar.

Jika proses atau utas lain telah mengatur ulang kartu, SCARD_W_RESET_CARD dikembalikan seperti yang diharapkan.

Windows Server 2008 R2, Windows 7, Windows Server 2008, Windows Vista, Windows Server 2003 dan Windows XP: Fungsi ini mengembalikan SCARD_S_SUCCESS meskipun proses atau utas lain telah mengatur ulang kartu. Untuk menentukan apakah kartu telah direset, panggil fungsi SCardStatus segera setelah memanggil fungsi ini.

Keterangan

Jika transaksi ditahan pada kartu selama lebih dari lima detik tanpa operasi yang terjadi pada kartu tersebut, maka kartu akan diatur ulang. Memanggil salah satu Smart Card dan Reader Access Functions atau Direct Card Access Functions pada kartu yang ditransaksikan menghasilkan timer yang direset untuk terus memungkinkan transaksi digunakan.

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

Contoh

Contoh berikut menunjukkan cara memulai transaksi kartu pintar. Contoh mengasumsikan bahwa lReturn adalah variabel jenis LONG yang ada dan merupakan handel valid yang hCard diterima dari panggilan sebelumnya ke SCardConnect.


lReturn = SCardBeginTransaction( hCard );
if ( SCARD_S_SUCCESS != lReturn )
 printf("Failed SCardBeginTransaction\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

SCardEndTransaction