SCardIntroduceCardTypeA 函数 (winscard.h)

项目
08/27/2023

SCardIntroduceCardType 函数通过将智能卡添加到智能卡数据库，为活动用户) 引入智能卡子系统 (。

语法

LONG SCardIntroduceCardTypeA(
  [in]           SCARDCONTEXT hContext,
  [in]           LPCSTR       szCardName,
  [in, optional] LPCGUID      pguidPrimaryProvider,
  [in, optional] LPCGUID      rgguidInterfaces,
  [in]           DWORD        dwInterfaceCount,
  [in]           LPCBYTE      pbAtr,
  [in]           LPCBYTE      pbAtrMask,
  [in]           DWORD        cbAtrLen
);

参数

[in] hContext

标识资源管理器上下文的句柄。资源管理器上下文是由之前对 SCardEstablishContext 的调用设置的。此参数不能为 NULL。

[in] szCardName

用户可识别卡的名称。

[in, optional] pguidPrimaryProvider

指向智能卡的主要服务提供商的标识符 (GUID) 的指针。

[in, optional] rgguidInterfaces

标识智能卡支持的接口的标识符数组 (GUID) 。

[in] dwInterfaceCount

rgguidInterfaces 数组中的标识符数。

[in] pbAtr

查询智能卡数据库 (时可用于匹配目的的 ATR 字符串，请参阅 SCardListCards) 。此字符串的长度由正常 ATR 分析确定。

[in] pbAtrMask

将智能卡的 ATR 与 pbAtr 中提供的 ATR 进行比较时要使用的可选位掩码。如果此值为非 NULL，则必须指向与 pbAtr 中提供的 ATR 字符串长度相同的字节字符串。将给定的 ATR 字符串 A 与 pbAtr 中提供的 ATR 进行比较时，该字符串仅当 A & M = pbAtr 时匹配，其中 M 是提供的掩码， & 表示按位 AND。

[in] cbAtrLen

ATR 和可选 ATR 掩码的长度。如果此值为零，则 ATR 的长度由正常 ATR 分析确定。如果提供了 pbAtr 值，则此值不能为零。

返回值

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

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

注解

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

SCardIntroduceCardType 函数是数据库管理功能。有关其他数据库管理功能的详细信息，请参阅智能卡数据库管理功能。

若要删除智能卡，请使用 SCardForgetCardType。

示例

以下示例演示如何引入卡类型。该示例假定 hContext 是从上一次调用 SCardEstablishContext 函数中获得的有效句柄。

GUID  MyGuid = { 0xABCDEF00,
                 0xABCD,
                 0xABCD,
                 0xAA, 0xBB, 0xCC, 0xDD,
                 0xAA, 0xBB, 0xCC, 0xDD };

static const BYTE MyATR[] =     { 0xaa, 0xbb, 0xcc, 0x00, 0xdd };
static const BYTE MyATRMask[] = { 0xff, 0xff, 0xff, 0x00, 0xff};

LONG            lReturn;

lReturn = SCardIntroduceCardType(hContext, 
                                 L"MyCardName",
                                 &MyGuid,
                                 NULL,    // No interface array
                                 0,       // Interface count = 0
                                 MyATR,
                                 MyATRMask,
                                 sizeof(MyATR));
if ( SCARD_S_SUCCESS != lReturn )
    printf("Failed SCardIntroduceCardType\n");

注意

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

要求


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