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

Статья
08/27/2023

Функция 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

Дескриптор, идентифицирующий контекст Resource Manager. Контекст диспетчера ресурсов задается предыдущим вызовом 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 в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора UNICODE. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования


Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	winscard.h
Библиотека	Winscard.lib
DLL	Winscard.dll

См. также раздел

SCardWriteCache