SCardAudit, fonction (winscard.h)

Article
08/27/2023

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

Partager via