SCardAudit-Funktion (winscard.h)

Artikel
08/27/2023

Die SCardAudit-Funktion schreibt Ereignismeldungen in das Windows-Anwendungsprotokoll Microsoft-Windows-SmartCard-Audit/Authentication.

Syntax

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

Parameter

[in] hContext

Handle, das den Ressourcen-Manager-Kontext identifiziert. Der Ressourcen-Manager-Kontext kann durch einen vorherigen Aufruf der SCardEstablishContext-Funktion festgelegt werden. Dieser Parameter darf nicht NULL sein.

[in] dwEvent

Das zu protokollierende Ereignis.

Wert	Bedeutung
SCARD_AUDIT_CHV_FAILURE 0x0	Bei einem Smart Karte Holder Verification (CHV) ist ein Fehler aufgetreten.
SCARD_AUDIT_CHV_SUCCESS 0x1	Ein Smart Karte Holder Verification (CHV) war erfolgreich.

Rückgabewert

Diese Funktion gibt unterschiedliche Werte zurück, je nachdem, ob sie erfolgreich ist oder fehlschlägt.

Rückgabecode	BESCHREIBUNG
Erfolgreich	SCARD_S_SUCCESS.
Fehler	Ein Fehlercode. Weitere Informationen finden Sie unter Smartcard-Rückgabewerte.

Hinweise

Diese Funktion wird nicht umgeleitet. Eine Anwendung, die die SCardAudit-Funktion innerhalb einer Remotedesktopsitzung aufruft, protokolliert das Ereignis auf dem Remotesystem.

Beispiele

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

Anforderungen


Unterstützte Mindestversion (Client)	Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winscard.h
Bibliothek	Winscard.lib
DLL	Winscard.dll

Freigeben über