Partager via


SCardAudit, fonction (winscard.h)

La fonction SCardAudit écrit des messages d’événement dans le journal des applications Windows Microsoft-Windows-SmartCard-Audit/Authentication.

Syntaxe

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

Paramètres

[in] hContext

Handle qui identifie le contexte resource manager. Le contexte du gestionnaire de ressources peut être défini par un appel précédent à la fonction SCardEstablishContext . Ce paramètre ne peut pas être NULL.

[in] dwEvent

Événement à journaliser.

Valeur Signification
SCARD_AUDIT_CHV_FAILURE
0x0
Une tentative de vérification du titulaire de carte intelligente (CHV) a échoué.
SCARD_AUDIT_CHV_SUCCESS
0x1
Une tentative intelligente de vérification du titulaire de carte (CHV) a réussi.

Valeur retournée

Cette fonction retourne des valeurs différentes selon qu’elle réussit ou échoue.

Code de retour Description
Success
SCARD_S_SUCCESS.
Échec
Code d'erreur. Pour plus d’informations, consultez Valeurs de retour de carte à puce.

Remarques

Cette fonction n’est pas redirigée. Une application appelant la fonction SCardAudit à partir d’une session Bureau à distance enregistre l’événement sur le système distant.

Exemples

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

Configuration requise

   
Client minimal pris en charge Windows 8 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2012 [applications de bureau uniquement]
Plateforme cible Windows
En-tête winscard.h
Bibliothèque Winscard.lib
DLL Winscard.dll