Compartilhar via

Função SCardAudit (winscard.h)

  • Artigo

A função SCardAudit grava mensagens de evento no log de aplicativos do Windows Microsoft-Windows-SmartCard-Audit/Authentication.

Sintaxe

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

Parâmetros

[in] hContext

Identificador que identifica o contexto do gerenciador de recursos. O contexto do gerenciador de recursos pode ser definido por uma chamada anterior para a função SCardEstablishContext . Esse parâmetro não pode ser NULL.

[in] dwEvent

O evento a ser registrado.

Valor Significado
SCARD_AUDIT_CHV_FAILURE
0x0
 Falha na tentativa de CHV (verificação de suporte de cartão inteligente).
SCARD_AUDIT_CHV_SUCCESS
0x1
 Uma tentativa de CHV (verificação de suporte de cartão inteligente) foi bem-sucedida.

Valor retornado

Essa função retorna valores diferentes dependendo se ela é bem-sucedida ou falha.

Código de retorno Descrição
Êxito
 SCARD_S_SUCCESS.
Falha
 Um código de erro. Para obter mais informações, consulte Valores retornados de cartão inteligente.

Comentários

Essa função não é redirecionada. Um aplicativo que chama a função SCardAudit de dentro de uma sessão de Área de Trabalho Remota registrará o evento no sistema remoto.

Exemplos

// 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 com suporte Windows 8 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2012 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho winscard.h
Biblioteca Winscard.lib
DLL Winscard.dll