SCardAudit 函数 (winscard.h)

  • 项目

SCardAudit 函数将事件消息写入 Windows 应用程序日志 Microsoft-Windows-SmartCard-Audit/Authentication。

语法

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

参数

[in] hContext

标识资源管理器上下文的句柄。 资源管理器上下文可以通过之前对 SCardEstablishContext 函数的调用来设置。 此参数不能为 NULL。

[in] dwEvent

要记录的事件。

值 含义
SCARD_AUDIT_CHV_FAILURE
0x0
 智能卡持有者验证 (CHV) 尝试失败。
SCARD_AUDIT_CHV_SUCCESS
0x1
 智能卡持有者验证 (CHV) 尝试成功。

返回值

此函数根据是成功还是失败返回不同的值。

返回代码 说明
Success
 SCARD_S_SUCCESS。
失败
 错误代码。 有关详细信息，请参阅 智能卡返回值。

注解

不会重定向此函数。 从远程桌面会话中调用 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
标头 winscard.h
Library Winscard.lib
DLL Winscard.dll