Fungsi SCardEndTransaction (winscard.h)

Fungsi SCardEndTransaction menyelesaikan transaksi yang dideklarasikan sebelumnya, memungkinkan aplikasi lain untuk melanjutkan interaksi dengan kartu.

Sintaks

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

Parameter

[in] hCard

Nilai referensi yang diperoleh dari panggilan sebelumnya ke SCardConnect. Nilai ini juga akan digunakan dalam panggilan sebelumnya ke SCardBeginTransaction.

[in] dwDisposition

Tindakan yang harus diambil pada kartu di pembaca yang terhubung saat ditutup.

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

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. Kemungkinan kode kesalahan mengikuti.

Mengembalikan kode/nilai

Deskripsi

SCARD_W_RESET_CARD 0x80100068L

Transaksi dirilis. Setiap komunikasi di masa mendatang dengan kartu memerlukan panggilan ke fungsi SCardReconnect . Windows Server 2008, Windows Vista, Windows Server 2003 dan Windows XP: Transaksi tidak dirilis. Aplikasi harus segera memanggil fungsi SCardDisconnect, SCardReconnect, atau SCardReleaseContext untuk menghindari transaksi yang ada memblokir utas dan proses lain agar tidak berkomunikasi dengan kartu pintar.

Keterangan

Fungsi SCardEndTransaction 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 transaksi kartu pintar. Contoh mengasumsikan bahwa lReturn adalah variabel tipe LONG yang valid, bahwa hCard adalah handel valid yang diterima dari panggilan sebelumnya ke fungsi SCardConnect , dan bahwa hCard diteruskan ke panggilan sebelumnya ke fungsi SCardBeginTransaction .

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

Transaksi SCardBegin

SCardConnect