Share via

Функция SCardAudit (winscard.h)

  • Статья

Функция SCardAudit записывает сообщения о событиях в журнал приложений Windows Microsoft-Windows-SmartCard-Audit/Authentication.

Синтаксис

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

Параметры

[in] hContext

Дескриптор, идентифицирующий контекст Resource Manager. Контекст диспетчера ресурсов можно задать с помощью предыдущего вызова функции SCardEstablishContext . Этот параметр не может иметь значение NULL.

[in] dwEvent

Событие для записи в журнал.

Значение Значение
SCARD_AUDIT_CHV_FAILURE
0x0
 Попытка проверки владельца интеллектуального карта (CHV) завершилась сбоем.
SCARD_AUDIT_CHV_SUCCESS
0x1
 Попытка проверки владельца интеллектуального карта (CHV) выполнена успешно.

Возвращаемое значение

Эта функция возвращает различные значения в зависимости от того, является ли она успешной или неудачной.

Код возврата Описание
Успешно
 SCARD_S_SUCCESS.
Failure
 Код ошибки. Дополнительные сведения см. в разделе Возвращаемые значения смарт-карты.

Комментарии

Эта функция не перенаправляется. Приложение, вызывающее функцию SCardAudit из сеанса удаленного рабочего стола, регистрирует событие в удаленной системе.

Примеры

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

Требования

   
Минимальная версия клиента Windows 8 [только классические приложения]
Минимальная версия сервера Windows Server 2012 [только классические приложения]
Целевая платформа Windows
Header winscard.h
Библиотека Winscard.lib
DLL Winscard.dll