Fungsi SCardAudit (winscard.h)

Artikel
08/27/2023

Fungsi SCardAudit menulis pesan peristiwa ke log aplikasi Windows Microsoft-Windows-SmartCard-Audit/Authentication.

Sintaks

LONG SCardAudit(
  [in] SCARDCONTEXT hContext,
  [in] DWORD        dwEvent
);

Parameter

[in] hContext

Menangani yang mengidentifikasi konteks resource manager. Konteks resource manager dapat diatur oleh panggilan sebelumnya ke fungsi SCardEstablishContext . Parameter ini tidak boleh NULL.

[in] dwEvent

Peristiwa yang akan dicatat.

Nilai	Makna
SCARD_AUDIT_CHV_FAILURE 0x0	Upaya verifikasi pemegang kartu pintar (CHV) gagal.
SCARD_AUDIT_CHV_SUCCESS 0x1	Upaya verifikasi pemegang kartu pintar (CHV) berhasil.

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 ini tidak dialihkan. Aplikasi yang memanggil fungsi SCardAudit dari dalam sesi Desktop Jauh akan mencatat peristiwa pada sistem jarak jauh.

Contoh

// hContext was set by a previous call to SCardEstablishContext.
lReturn = SCardAudit (hContext,
                      SCARD_AUDIT_CHV_SUCCESS);

if ( SCARD_S_SUCCESS != lReturn )
{
    printf("Failed SCardAudit - %x\n", lReturn);
    // Take appropriate action
}

Persyaratan


Klien minimum yang didukung	Windows 8 [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2012 [hanya aplikasi desktop]
Target Platform	Windows
Header	winscard.h
Pustaka	Winscard.lib
DLL	Winscard.dll

Bagikan melalui