SCardListInterfacesA 函数 (winscard.h)

项目
08/27/2023

SCardListInterfaces 函数提供给定卡提供的接口列表。

调用方提供以前引入子系统的智能卡的名称，并接收卡支持的接口列表。

语法

LONG SCardListInterfacesA(
  [in]      SCARDCONTEXT hContext,
  [in]      LPCSTR       szCard,
  [out]     LPGUID       pguidInterfaces,
  [in, out] LPDWORD      pcguidInterfaces
);

参数

[in] hContext

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

[in] szCard

已引入智能卡子系统的智能卡的名称。

[out] pguidInterfaces

接口标识符数组 (GUID) ，这些 GUID 指示智能卡支持的接口。如果此值为 NULL，SCardListInterfaces 将忽略 pcguidInterfaces 中提供的数组长度，返回如果此参数不是 pcguidInterfaces 的 NULL，则返回的数组大小以及成功代码。

[in, out] pcguidInterfaces

pcguidInterfaces 数组的大小，并接收返回数组的实际大小。如果数组大小指定为 SCARD_AUTOALLOCATE，则 pcguidInterfaces 将转换为指向 GUID 指针的指针，并接收包含数组的内存块的地址。此内存块必须与 SCardFreeMemory 一起解除分配。

返回值

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

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

注解

此函数不会重定向，但在尝试远程桌面会话时调用该函数不会导致错误。它仅表示结果来自远程计算机，而不是来自本地计算机。

SCardListInterfaces 函数是数据库查询函数。有关其他数据库查询函数的详细信息，请参阅智能卡数据库查询函数。

示例

以下示例显示列出智能卡的接口。

LPGUID          pGuids = NULL;
LONG            lReturn;
DWORD           cGuid = SCARD_AUTOALLOCATE;

// Retrieve the list of interfaces.
lReturn = SCardListInterfaces(NULL,
                              (LPCSTR) "MyCard",
                              (LPGUID)&pGuids,
                              &cGuid );
if ( SCARD_S_SUCCESS != lReturn )
{
    printf("Failed SCardListInterfaces\n");
    exit(1);   // Or other appropriate action
}

if ( 0 != cGuid )
{
    // Do something with the array of Guids.
    // Remember to free pGuids when done (by SCardFreeMemory).
    // ...
}

注意

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

要求


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