Fungsi SCardAudit (winscard.h)

  • Artikel

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