SCardAudit function (winscard.h)

The SCardAudit function writes event messages to the Windows application log Microsoft-Windows-SmartCard-Audit/Authentication.

Syntax

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

Parameters

[in] hContext

Handle that identifies the resource manager context. The resource manager context can be set by a previous call to the SCardEstablishContext function. This parameter cannot be NULL.

[in] dwEvent

The event to log.

Return value

This function returns different values depending on whether it succeeds or fails.

Remarks

This function is not redirected. An application calling the SCardAudit function from within a Remote Desktop session will log the event on the remote system.

Examples

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

Requirements