Compartir a través de

Función SCardAudit (winscard.h)

  • Artículo

La función SCardAudit escribe mensajes de evento en el registro de aplicaciones de Windows Microsoft-Windows-SmartCard-Audit/Authentication.

Sintaxis

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

Parámetros

[in] hContext

Identificador que identifica el contexto del administrador de recursos. El contexto del administrador de recursos se puede establecer mediante una llamada anterior a la función SCardEstablishContext . Este parámetro no puede ser NULL.

[in] dwEvent

Evento que se va a registrar.

Value Significado
SCARD_AUDIT_CHV_FAILURE
0x0
 Error en un intento de comprobación del titular de la tarjeta inteligente (CHV).
SCARD_AUDIT_CHV_SUCCESS
0x1
 Se realizó correctamente un intento de verificación del titular de la tarjeta inteligente (CHV).

Valor devuelto

Esta función devuelve valores diferentes en función de si se realiza correctamente o no.

Código devuelto Descripción
Success
 SCARD_S_SUCCESS.
Error
 Código de error. Para obtener más información, consulte Valores devueltos de tarjeta inteligente.

Comentarios

Esta función no se redirige. Una aplicación que llama a la función SCardAudit desde una sesión de Escritorio remoto registrará el evento en el sistema remoto.

Ejemplos

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

Requisitos

   
Cliente mínimo compatible Windows 8 [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2012 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado winscard.h
Library Winscard.lib
Archivo DLL Winscard.dll