通过

SCardLocateCardsByATRA 函数 （winscard.h）

  • 项目

SCardLocateCardsByATR 函数搜索 rgReaderStates 参数中列出的读取器，该卡片的名称与 rgAtrMasks 参数指定的其中一个 SCARD_ATRMASK 结构中包含的卡片名称匹配。

语法

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 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息，请参阅函数原型的 约定。

要求

要求 价值
最低支持的客户端 Windows XP [仅限桌面应用]
支持的最低服务器 Windows Server 2003 [仅限桌面应用]
目标平台 窗户
标头 winscard.h
库 Winscard.lib
DLL Winscard.dll