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

Статья
11/20/2024

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

Синтаксис

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

Параметры

[in] hContext

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

[in] rgAtrMasks

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

[in] cAtrs

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

[in, out] rgReaderStates

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

[in] cReaders

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

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

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

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

Замечания

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

Функция SCardLocateCardsByATR — это функция отслеживания смарт-карт. Сведения о других функциях отслеживания см. в функциях отслеживания смарт-карт.

Заметка

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

Требования

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

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