共用方式為

SCardWriteCacheA 函式 (winscard.h)

  • 發行項

SCardWriteCache函式會將名稱/值組從智慧卡寫入智慧卡所維護的全域快取Resource Manager。

語法

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

參數

[in] hContext

識別 資源管理員內容的控制碼。 資源管理員內容是由先前對 SCardEstablishCoNtext的呼叫所設定。

[in] CardIdentifier

值指標，可唯一識別讀取名稱/值組的智慧卡。

[in] FreshnessCounter

快取資料的目前修訂。

[in] LookupName

Null 終止字串的指標，其中包含要寫入全域快取之名稱/值組的名稱部分。

[in] Data

位元組值的陣列指標，其中包含要寫入全域快取之名稱/值組的值部分。

[in] DataLen

資料緩衝區的大小，以位元組為單位。

傳回值

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

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

傳回碼/值 描述
SCARD_W_CACHE_ITEM_TOO_BIG
0x80100072
 指定之名稱/值組的大小超過為全域快取定義的大小上限。

備註

注意

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

規格需求

   
最低支援的用戶端 Windows Vista [僅限傳統型應用程式]
最低支援的伺服器 Windows Server 2008 [僅限傳統型應用程式]
目標平台 Windows
標頭 winscard.h
程式庫 Winscard.lib
Dll Winscard.dll

另請參閱

SCardReadCache