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

Статья
11/20/2024

Функция SCardWriteCache записывает пару "имя-значение" из смарт-карты в глобальный кэш, поддерживаемый Smart Card 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, которая содержит часть имени пары name-value для записи в глобальный кэш.

[in] Data

Указатель на массив байтовых значений, содержащий часть значения пары "имя-значение", для записи в глобальный кэш.

[in] DataLen

Размер буфера данных в байтах.

Возвращаемое значение

Если функция успешно выполнена, она возвращает SCARD_S_SUCCESS.

Если функция завершается ошибкой, она возвращает один из следующих кодов ошибок. Дополнительные сведения см. в возвращаемых значений смарт-карт.

Возврат кода или значения	Описание
SCARD_W_CACHE_ITEM_TOO_BIG 0x80100072	Размер указанной пары "имя-значение" превышает максимальный размер, определенный для глобального кэша.

Замечания

Заметка

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

Требования

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

См. также

SCardReadCache

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