winscard.h 标头

此标头由安全和标识使用。 有关详细信息，请参阅：

• 安全和标识

winscard.h 包含以下编程接口：

函数

GetOpenCardNameA GetOpenCardName 函数显示智能卡“选择卡”对话框。 (ANSI)
GetOpenCardNameW GetOpenCardName 函数显示智能卡“选择卡”对话框。 (Unicode)
SCardAccessStartedEvent 当事件指示智能卡资源管理器已启动时，返回事件句柄。
SCardAddReaderToGroupA 将读取器添加到读取器组。 (ANSI)
SCardAddReaderToGroupW 将读取器添加到读取器组。 (Unicode)
SCardAudit 将事件消息写入 Windows 应用程序日志 Microsoft-Windows-SmartCard-Audit/Authentication。
SCardBeginTransaction 启动事务。
SCardCancel 终止特定资源管理器上下文中所有未完成的操作。
SCardConnectA 使用特定的资源管理器上下文) 在调用应用程序和特定读取器包含的智能卡之间建立连接 (。 如果指定的读取器中不存在卡，则返回错误。 (ANSI)
SCardConnectW 使用特定的资源管理器上下文) 在调用应用程序和特定读取器包含的智能卡之间建立连接 (。 如果指定的读取器中不存在卡，则返回错误。 (Unicode)
SCardControl 让你直接控制读取器。 在成功调用 SCardConnect 之后和成功调用 SCardDisconnect 之前，可以随时调用它。
SCardDisconnect 终止以前在调用应用程序和目标读取器中的智能卡之间打开的连接。
SCardEndTransaction 完成以前声明的事务，允许其他应用程序恢复与卡交互。
SCardEstablishContext 建立资源管理器上下文 (执行数据库操作的范围) 。
SCardForgetCardTypeA 从智能卡子系统中删除引入的智能卡。 (ANSI)
SCardForgetCardTypeW 从智能卡子系统中删除引入的智能卡。 (Unicode)
SCardForgetReaderA 将以前引入的读取器从智能卡子系统的控制中删除。 它将从智能卡数据库中删除，包括从可能已添加到的任何读取器组中。 (ANSI)
SCardForgetReaderGroupA 从智能卡子系统中删除以前引入的智能卡读取器组。 尽管此函数会自动清除组中的所有读取器，但它不会影响数据库中各个读取器的存在。 (ANSI)
SCardForgetReaderGroupW 从智能卡子系统中删除以前引入的智能卡读取器组。 尽管此函数会自动清除组中的所有读取器，但它不会影响数据库中各个读取器的存在。 (Unicode)
SCardForgetReaderW 将以前引入的读取器从智能卡子系统的控制中删除。 它将从智能卡数据库中删除，包括从可能已添加到的任何读取器组中。 (Unicode)
SCardFreeMemory 释放使用SCARD_AUTOALLOCATE长度指示符从资源管理器返回的内存。
SCardGetAttrib 检索给定句柄的当前读取器属性。 它不会影响读取器、驱动程序或卡的状态。
SCardGetCardTypeProviderNameA 返回模块的名称 (动态链接库) ，其中包含给定卡名称和提供程序类型的提供程序。 (ANSI)
SCardGetCardTypeProviderNameW 返回模块的名称 (动态链接库) ，其中包含给定卡名称和提供程序类型的提供程序。 (Unicode)
SCardGetDeviceTypeIdA 获取给定读取器名称卡读取器的设备类型标识符。 此函数不影响读取器的状态。 (ANSI)
SCardGetDeviceTypeIdW 获取给定读取器名称卡读取器的设备类型标识符。 此函数不影响读取器的状态。 (Unicode)
SCardGetProviderIdA 返回给定卡的主要服务提供商的标识符 (GUID) 。 (ANSI)
SCardGetProviderIdW 返回给定卡的主要服务提供商的标识符 (GUID) 。 (Unicode)
SCardGetReaderDeviceInstanceIdA 获取给定读取器名称的卡读取器的设备实例标识符。 此函数不影响读取器的状态。 (ANSI)
SCardGetReaderDeviceInstanceIdW 获取给定读取器名称的卡读取器的设备实例标识符。 此函数不影响读取器的状态。 (Unicode)
SCardGetReaderIconA 获取给定读取器名称的智能卡读取器的图标。 (ANSI)
SCardGetReaderIconW 获取给定读取器名称的智能卡读取器的图标。 (Unicode)
SCardGetStatusChangeA 阻止执行，直到特定读取器集中卡的当前可用性发生更改。 (ANSI)
SCardGetStatusChangeW 阻止执行，直到特定读取器集中卡的当前可用性发生更改。 (Unicode)
SCardGetTransmitCount 检索自插入指定卡读取器以来已完成的传输操作数。
SCardIntroduceCardTypeA 通过将智能卡添加到智能卡数据库，为活动用户) 引入智能卡子系统 (。 (ANSI)
SCardIntroduceCardTypeW 通过将智能卡添加到智能卡数据库，为活动用户) 引入智能卡子系统 (。 (Unicode)
SCardIntroduceReaderA 为现有智能卡读取器引入新名称。 (ANSI)
SCardIntroduceReaderGroupA 将读取器组引入智能卡子系统。 但是，在将读取器添加到智能卡数据库时指定该组之前，不会创建读取器组。 (ANSI)
SCardIntroduceReaderGroupW 将读取器组引入智能卡子系统。 但是，在将读取器添加到智能卡数据库时指定该组之前，不会创建读取器组。 (Unicode)
SCardIntroduceReaderW 为现有智能卡读取器引入新名称。 (Unicode)
SCardIsValidContext 确定智能卡上下文句柄是否有效。
SCardListCardsA 搜索智能卡数据库，并提供用户之前引入系统的命名卡列表。 (ANSI)
SCardListCardsW 搜索智能卡数据库，并提供用户之前引入系统的命名卡列表。 (Unicode)
SCardListInterfacesA 提供给定卡提供的接口列表。 (ANSI)
SCardListInterfacesW 提供给定卡提供的接口列表。 (Unicode)
SCardListReaderGroupsA 提供之前已引入系统的读取器组的列表。 (ANSI)
SCardListReaderGroupsW 提供之前已引入系统的读取器组的列表。 (Unicode)
SCardListReadersA 提供一组命名读取器组中的读取器列表，消除重复项。 (ANSI)
SCardListReadersW 提供一组命名读取器组中的读取器列表，消除重复项。 (Unicode)
SCardListReadersWithDeviceInstanceIdA 获取已提供设备实例标识符的读取器列表。 此函数不影响读取器的状态。 (ANSI)
SCardListReadersWithDeviceInstanceIdW 获取已提供设备实例标识符的读取器列表。 此函数不影响读取器的状态。 (Unicode)
SCardLocateCardsA 在 rgReaderStates 参数中列出的读取器中搜索卡，该字符串与 mszCards 中指定的卡名称之一匹配，并立即返回结果。 (ANSI)
SCardLocateCardsByATRA 在 rgReaderStates 参数中列出的读取器中搜索卡，其名称与 rgAtrMasks 参数指定的SCARD_ATRMASK结构之一中包含的卡名称之一相匹配。 (ANSI)
SCardLocateCardsByATRW 在 rgReaderStates 参数中列出的读取器中搜索卡，其名称与 rgAtrMasks 参数指定的SCARD_ATRMASK结构之一中包含的卡名称之一相匹配。 (Unicode)
SCardLocateCardsW 在 rgReaderStates 参数中列出的读取器中搜索卡，该字符串与 mszCards 中指定的卡名称之一匹配，并立即返回结果。 (Unicode)
SCardReadCacheA 从智能卡资源管理器维护的全局缓存中检索名称/值对的值部分。 (ANSI)
SCardReadCacheW 从智能卡资源管理器维护的全局缓存中检索名称/值对的值部分。 (Unicode)
SCardReconnect 重新建立调用应用程序和智能卡之间的现有连接。
SCardReleaseContext 关闭已建立的资源管理器上下文，释放在该上下文下分配的任何资源，包括 SCARDHANDLE 对象和使用SCARD_AUTOALLOCATE长度指示符分配的内存。
SCardReleaseStartedEvent 递减以前调用 SCardAccessStartedEvent 函数获取的句柄的引用计数。
SCardRemoveReaderFromGroupA 从现有读取器组中删除读取器。 此函数对读取器没有影响。 (ANSI)
SCardRemoveReaderFromGroupW 从现有读取器组中删除读取器。 此函数对读取器没有影响。 (Unicode)
SCardSetAttrib 设置给定句柄的给定读取器属性。
SCardSetCardTypeProviderNameA 指定模块的名称 (动态链接库) 包含给定卡名称和提供程序类型的提供程序。 (ANSI)
SCardSetCardTypeProviderNameW 指定模块的名称 (动态链接库) 包含给定卡名称和提供程序类型的提供程序。 (Unicode)
SCardStatusA 提供读取器中智能卡的当前状态。 (ANSI)
SCardStatusW 提供读取器中智能卡的当前状态。 (Unicode)
SCardTransmit 向智能卡发送服务请求，并期望从卡接收数据。
SCardUIDlgSelectCardA 显示智能卡选择卡片对话框。 (ANSI)
SCardUIDlgSelectCardW 显示智能卡选择卡片对话框。 (Unicode)
SCardWriteCacheA 将智能卡的名称/值对写入智能卡资源管理器维护的全局缓存。 (ANSI)
SCardWriteCacheW 将智能卡的名称/值对写入智能卡资源管理器维护的全局缓存。 (Unicode)

结构

OPENCARD_SEARCH_CRITERIAA SCardUIDlgSelectCard 函数使用 OPENCARD_SEARCH_CRITERIA 结构来识别满足调用方规定的要求的卡。 但是，可以在不使用此结构的情况下调用 SCardUIDlgSelectCard。 (ANSI)
OPENCARD_SEARCH_CRITERIAW SCardUIDlgSelectCard 函数使用 OPENCARD_SEARCH_CRITERIA 结构来识别满足调用方规定的要求的卡。 但是，可以在不使用此结构的情况下调用 SCardUIDlgSelectCard。 (Unicode)
OPENCARDNAME_EXA OPENCARDNAME_EX 结构包含 SCardUIDlgSelectCard 函数用于初始化智能卡选择卡片对话框的信息。 (ANSI)
OPENCARDNAME_EXW OPENCARDNAME_EX 结构包含 SCardUIDlgSelectCard 函数用于初始化智能卡选择卡片对话框的信息。 (Unicode)
OPENCARDNAMEA 包含 GetOpenCardName 函数用于初始化智能卡选择卡片对话框的信息。 (ANSI)
OPENCARDNAMEW 包含 GetOpenCardName 函数用于初始化智能卡选择卡片对话框的信息。 (Unicode)
SCARD_ATRMASK 由 SCardLocateCardsByATR 函数用于查找卡片。
SCARD_READERSTATEA 由函数用于跟踪读卡器中的智能卡。 (ANSI)
SCARD_READERSTATEW 由函数用于跟踪读卡器中的智能卡。 (Unicode)