SCardGetDeviceTypeIdA 函数 (winscard.h)

SCardGetDeviceTypeId 函数获取给定读取器名称卡读取器的设备类型标识符。 此函数不影响读取器的状态。

语法

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

参数

[in] hContext

标识查询的资源管理器上下文的句柄。 可以通过调用 SCardEstablishContext 函数来设置资源管理器上下文。 此参数不能为 NULL。

[in] szReaderName

读取者名称。 可以通过调用 SCardListReaders 函数来获取此值。

[in, out] pdwDeviceTypeId

实际设备类型标识符。 此函数返回的读取器类型列表在 SCARD_READER_CAPABILITIES 结构中的 ReaderType 成员下列出。

返回值

此函数根据是成功还是失败返回不同的值。

返回代码	说明
Success	SCARD_S_SUCCESS。
失败	错误代码。 有关详细信息，请参阅 智能卡返回值。

注解

注意

winscard.h 标头将 SCardGetDeviceTypeId 定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。 有关详细信息，请参阅 函数原型的约定。

要求

要求	值
最低受支持的客户端	Windows 8 [仅限桌面应用]
最低受支持的服务器	Windows Server 2012 [仅限桌面应用]
目标平台	Windows
标头	winscard.h
DLL	Winscard.dll