Fungsi SCardCancel (winscard.h)

Fungsi SCardCancel mengakhiri semua tindakan yang luar biasa dalam konteks manajer sumber daya tertentu.

Satu-satunya permintaan yang dapat Anda batalkan adalah permintaan yang memerlukan menunggu tindakan eksternal oleh kartu pintar atau pengguna. Setiap permintaan tindakan yang luar biasa tersebut akan berakhir dengan indikasi status bahwa tindakan dibatalkan. Ini sangat berguna untuk memaksa panggilan SCardGetStatusChange yang luar biasa untuk dihentikan.

Sintaks

LONG SCardCancel(
  [in] SCARDCONTEXT hContext
);

Parameter

[in] hContext

Menangani yang mengidentifikasi konteks resource manager. Konteks resource manager diatur oleh panggilan sebelumnya ke SCardEstablishContext.

Mengembalikan nilai

Fungsi ini mengembalikan nilai yang berbeda tergantung pada apakah berhasil atau gagal.

Keterangan

Fungsi SCardCancel adalah fungsi pelacakan kartu pintar. Untuk deskripsi fungsi pelacakan lainnya, lihat Fungsi Pelacakan Kartu Pintar.

Contoh

Contoh berikut membatalkan semua tindakan yang beredar dalam konteks yang ditentukan. Contoh mengasumsikan bahwa lReturn adalah variabel jenis LONG yang ada dan hContext adalah handel valid yang diterima dari panggilan sebelumnya ke SCardEstablishContext.

lReturn = SCardCancel( hContext );
if ( SCARD_S_SUCCESS != lReturn )
    printf("Failed SCardCancel\n");

Persyaratan

Lihat juga

SCardEstablishContext

SCardGetStatusChange

SCardLocateCards