Funzione SCardAudit (winscard.h)

Articolo
08/27/2023

La funzione SCardAudit scrive messaggi di evento nel log dell'applicazione Windows Microsoft-Windows-SmartCard-Audit/Authentication.

Sintassi

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

Parametri

[in] hContext

Handle che identifica il contesto di Resource Manager. Il contesto di Resource Manager può essere impostato da una chiamata precedente alla funzione SCardEstablishContext . Questo parametro non può essere NULL.

[in] dwEvent

Evento da registrare.

Valore	Significato
SCARD_AUDIT_CHV_FAILURE 0x0	Tentativo di verifica del titolare della smart card (CHV) non riuscito.
SCARD_AUDIT_CHV_SUCCESS 0x1	Tentativo di verifica del titolare della smart card (CHV) riuscito.

Valore restituito

Questa funzione restituisce valori diversi a seconda che abbia esito positivo o negativo.

Codice restituito	Descrizione
Success	SCARD_S_SUCCESS.
Operazioni non riuscite	Codice di errore. Per altre informazioni, vedere Valori restituiti smart card.

Commenti

Questa funzione non viene reindirizzata. Un'applicazione che chiama la funzione SCardAudit dall'interno di una sessione desktop remoto registra l'evento nel sistema remoto.

Esempio

// 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
}

Requisiti


Client minimo supportato	Windows 8 [solo app desktop]
Server minimo supportato	Windows Server 2012 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winscard.h
Libreria	Winscard.lib
DLL	Winscard.dll

Condividi tramite