Fungsi SCardReadCacheA (winscard.h)

  • Artikel

Fungsi SCardReadCache mengambil bagian nilai dari pasangan nama-nilai dari cache global yang dikelola oleh Resource Manager Kartu Pintar.

Sintaks

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

Parameter

[in] hContext

Handel yang mengidentifikasi konteks resource manager. Konteks manajer sumber daya diatur oleh panggilan sebelumnya ke SCardEstablishContext.

[in] CardIdentifier

Penunjuk ke nilai yang secara unik mengidentifikasi kartu pintar. Pasangan nama-nilai yang dibaca fungsi ini dari cache global dikaitkan dengan kartu pintar ini.

[in] FreshnessCounter

Revisi data cache saat ini.

[in] LookupName

Penunjuk ke string yang dihentikan null yang berisi bagian nama dari pasangan nama-nilai untuk mengambil bagian nilai.

[out] Data

Penunjuk ke array nilai byte yang berisi bagian nilai dari pasangan nama-nilai yang ditentukan oleh parameter LookupName .

[out] DataLen

Penunjuk ke ukuran, dalam byte, dari buffer Data .

Mengembalikan nilai

Jika fungsi berhasil, fungsi akan mengembalikan SCARD_S_SUCCESS.

Jika fungsi gagal, fungsi akan mengembalikan salah satu kode kesalahan berikut. Untuk informasi selengkapnya, lihat Nilai Pengembalian Kartu Pintar.

Mengembalikan kode/nilai Deskripsi
SCARD_W_CACHE_ITEM_NOT_FOUND
0x80100070
 Pasangan nama-nilai yang ditentukan tidak ditemukan di cache global.
SCARD_W_CACHE_ITEM_STALE
0x80100071
 Pasangan nama-nilai yang ditentukan lebih lama dari yang diminta dan telah dihapus dari cache.

Keterangan

Catatan

Header winscard.h mendefinisikan SCardReadCache sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

   
Klien minimum yang didukung Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2008 [hanya aplikasi desktop]
Target Platform Windows
Header winscard.h
Pustaka Winscard.lib
DLL Winscard.dll

Lihat juga

SCardWriteCache