共用方式為

SCardReadCacheA 函式 （winscard.h）

  • 發行項

SCardReadCache 函式會從 智慧卡 Resource Manager 所維護的全域快取擷取名稱/值組的值部分。

語法

LONG SCardReadCacheA(
  [in]  SCARDCONTEXT hContext,
  [in]  UUID         *CardIdentifier,
  [in]  DWORD        FreshnessCounter,
  [in]  LPSTR        LookupName,
  [out] PBYTE        Data,
  [out] DWORD        *DataLen
);

參數

[in] hContext

識別資源管理員內容之 句柄。 資源管理員內容是由先前呼叫 SCardEstablishContext所設定。

[in] CardIdentifier

可唯一識別智慧卡之值的指標。 此函式從全域快取讀取的名稱/值組與此智慧卡相關聯。

[in] FreshnessCounter

快取數據的目前修訂。

[in] LookupName

Null 終止字串的指標，其中包含要擷取值部分之名稱值組的名稱部分。

[out] Data

位元組值的陣列指標，其中包含 LookupName 參數所指定之名稱/值組的值部分。

[out] DataLen

數據 緩衝區的大小指標，以位元組為單位。

傳回值

如果函式成功，它會傳回 SCARD_S_SUCCESS。

如果函式失敗，它會傳回下列其中一個錯誤碼。 如需詳細資訊，請參閱智慧卡傳回值。

傳回碼/值 描述
SCARD_W_CACHE_ITEM_NOT_FOUND
0x80100070
 全域快取中找不到指定的名稱/值組。
SCARD_W_CACHE_ITEM_STALE
0x80100071
 指定的名稱/值組比要求還舊，而且已從快取中刪除。

言論

注意

winscard.h 標頭會將 SCardReadCache 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的 慣例。

要求

要求 價值
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
支援的最低伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平臺 窗戶
標頭 winscard.h
連結庫 Winscard.lib
DLL Winscard.dll

另請參閱

SCardWriteCache