Функция SCardReadCacheA (winscard.h)

Статья
11/20/2024

Функция SCardReadCache извлекает часть значения пары "имя-значение" из глобального кэша, поддерживаемого диспетчером ресурсов смарт-карт.

Синтаксис

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	Указанная пара name-value не найдена в глобальном кэше.
SCARD_W_CACHE_ITEM_STALE 0x80100071	Указанная пара "имя-значение" была старше запрошенной и удалена из кэша.

Замечания

Заметка

Заголовок winscard.h определяет SCardReadCache как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows Vista [только классические приложения]
минимальный поддерживаемый сервер	Windows Server 2008 [только классические приложения]
целевая платформа	Виндоус
заголовка	winscard.h
библиотеки	Winscard.lib
DLL	Winscard.dll

См. также

SCardWriteCache

Поделиться через