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

Статья
11/20/2024

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

Синтаксис

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

Параметры

[in] hContext

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

[in] szReaderName

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

[in, out] pdwDeviceTypeId

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

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

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

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

Замечания

Заметка

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

Требования

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

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