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

  • Статья

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

Синтаксис

LONG SCardGetDeviceTypeIdA(
  [in]      SCARDCONTEXT hContext,
  [in]      LPCSTR       szReaderName,
  [in, out] LPDWORD      pdwDeviceTypeId
);

Параметры

[in] hContext

Дескриптор, идентифицирующий контекст Resource Manager для запроса. Контекст диспетчера ресурсов можно задать, вызвав функцию SCardEstablishContext . Значение этого параметра не может быть равно NULL.

[in] szReaderName

Имя средства чтения. Это значение можно получить, вызвав функцию SCardListReaders .

[in, out] pdwDeviceTypeId

Фактический идентификатор типа устройства. Список типов средств чтения, возвращаемых этой функцией, отображается в разделе Элемент ReaderType в структуре SCARD_READER_CAPABILITIES .

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

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

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

Комментарии

Примечание

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

Требования

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