Fungsi SCardCancel (winscard.h)

  • Artikel

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.

Menampilkan kode Deskripsi
Berhasil
 SCARD_S_SUCCESS.
Kegagalan
 Kode kesalahan. Untuk informasi selengkapnya, lihat Nilai Pengembalian Kartu Pintar.

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

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

SCardEstablishContext

SCardGetStatusChange

SCardLocateCards