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

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

Требования

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

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

SCardReadCache