Fungsi SCardControl (winscard.h)

Artikel
03/04/2024

Fungsi SCardControl memberi Anda kontrol langsung pembaca. Anda dapat memanggilnya kapan saja setelah panggilan berhasil ke SCardConnect dan sebelum panggilan berhasil ke SCardDisconnect. Efek pada status pembaca tergantung pada kode kontrol.

Sintaks

LONG SCardControl(
  [in]  SCARDHANDLE hCard,
  [in]  DWORD       dwControlCode,
  [in]  LPCVOID     lpInBuffer,
  [in]  DWORD       cbInBufferSize,
  [out] LPVOID      lpOutBuffer,
  [in]  DWORD       cbOutBufferSize,
  [out] LPDWORD     lpBytesReturned
);

Parameter

[in] hCard

Nilai referensi yang dikembalikan dari SCardConnect.

[in] dwControlCode

Kode kontrol untuk operasi. Nilai ini mengidentifikasi operasi tertentu yang akan dilakukan.

[in] lpInBuffer

Penunjuk ke buffer yang berisi data yang diperlukan untuk melakukan operasi. Parameter ini dapat berupa NULL jika parameter dwControlCode menentukan operasi yang tidak memerlukan data input.

[in] cbInBufferSize

Ukuran, dalam byte, dari buffer yang diacu oleh lpInBuffer.

[out] lpOutBuffer

Penunjuk ke buffer yang menerima data output operasi. Parameter ini dapat berupa NULL jika parameter dwControlCode menentukan operasi yang tidak menghasilkan data output.

[in] cbOutBufferSize

Ukuran, dalam byte, dari buffer yang diacu oleh lpOutBuffer.

[out] lpBytesReturned

Penunjuk ke DWORD yang menerima ukuran, dalam byte, dari data yang disimpan ke dalam buffer yang ditujukkan oleh lpOutBuffer.

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 SCardControl adalah fungsi akses kartu langsung. Untuk informasi selengkapnya tentang fungsi akses langsung lainnya, lihat Fungsi Akses Kartu Langsung.

Contoh

Contoh berikut mengeluarkan kode kontrol. Contoh mengasumsikan bahwa hCardHandle adalah handel valid yang diterima dari panggilan sebelumnya ke SCardConnect dan bahwa dwControlCode adalah variabel jenis DWORD yang sebelumnya diinisialisasi ke kode kontrol yang valid. Kode kontrol khusus ini tidak memerlukan data input dan tidak mengharapkan data output.


lReturn = SCardControl( hCardHandle,
                        dwControlCode,
                        NULL,
                        0,
                        NULL,
                        0,
                        0 );
if ( SCARD_S_SUCCESS != lReturn )
    printf("Failed SCardControl\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