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

  • Статья

Функция SCardLocateCardsByATR выполняет поиск карта с именем, которое соответствует одному из карта имен, содержащихся в одной из структур SCARD_ATRMASK, указанных в параметре rgAtrMasks, у модулей чтения, перечисленных в параметре rgReaderStates.

Синтаксис

LONG SCardLocateCardsByATRA(
  [in]      SCARDCONTEXT         hContext,
  [in]      LPSCARD_ATRMASK      rgAtrMasks,
  [in]      DWORD                cAtrs,
  [in, out] LPSCARD_READERSTATEA rgReaderStates,
  [in]      DWORD                cReaders
);

Параметры

[in] hContext

Дескриптор, идентифицирующий контекст Resource Manager. Контекст диспетчера ресурсов задается предыдущим вызовом SCardEstablishContext.

[in] rgAtrMasks

Массив SCARD_ATRMASK структур, содержащих имена карточек, по которым выполняется поиск.

[in] cAtrs

Количество элементов в массиве rgAtrMasks .

[in, out] rgReaderStates

Массив SCARD_READERSTATE структур, указывающих средства чтения для поиска и получения результата.

[in] cReaders

Количество элементов в массиве rgReaderStates .

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

Эта функция возвращает различные значения в зависимости от того, является ли она успешной или неудачной.

Код возврата Описание
Успешно
 SCARD_S_SUCCESS.
Failure
 Код ошибки. Дополнительные сведения см. в разделе Возвращаемые значения смарт-карты.

Комментарии

Эта служба особенно полезна при использовании в сочетании с SCardGetStatusChange. Если совпадающие карточки не найдены с помощью SCardLocateCards, вызывающее приложение может использовать SCardGetStatusChange для ожидания изменений доступности карта.

Функция SCardLocateCardsByATR является интеллектуальной функцией отслеживания карта. Дополнительные сведения о других функциях отслеживания см. в разделе Функции отслеживания смарт-карт.

Примечание

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

Требования

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