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) 嘗試成功。

傳回值

此函式會根據它是否成功或失敗，傳回不同的值。

傳回碼 描述
「成功」
 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
程式庫 Winscard.lib
Dll Winscard.dll