通过

SCardGetCardTypeProviderNameA 函数 （winscard.h）

  • 项目

SCardGetCardTypeProviderName 函数返回模块（动态链接库）的名称，该模块（动态链接库）包含给定卡片名称和 提供程序类型。

语法

LONG SCardGetCardTypeProviderNameA(
  [in]      SCARDCONTEXT hContext,
  [in]      LPCSTR       szCardName,
  [in]      DWORD        dwProviderId,
  [out]     CHAR         *szProvider,
  [in, out] LPDWORD      pcchProvider
);

参数

[in] hContext

标识 资源管理器上下文的句柄。 可以通过上一次调用 SCardEstablishContext来设置资源管理器上下文。 如果调用 SCardGetCardTypeProviderName 未定向到特定的 上下文，则可以 NULL。

[in] szCardName

与此提供程序名称关联的卡片类型的名称。

[in] dwProviderId

与此卡片类型关联的提供程序的标识符。

价值 意义
SCARD_PROVIDER_PRIMARY
1
 该函数将 智能卡主服务提供商的名称检索为 GUID 字符串。
SCARD_PROVIDER_CSP
2
 该函数检索 加密服务提供程序的名称。
SCARD_PROVIDER_KSP
3
 该函数检索智能卡 密钥存储提供程序（KSP）的名称。
SCARD_PROVIDER_CARD_MODULE
0x80000001
 该函数检索卡片模块的名称。

[out] szProvider

成功完成此函数后，接收 提供程序名称的字符串变量。

[in, out] pcchProvider

指向 DWORD 值的指针。 在输入时，pcchProvider 以字符为单位提供 szProvider 缓冲区的长度。 如果此值SCARD_AUTOALLOCATE，则 szProvider 转换为指向字节指针的指针，并接收包含字符串的内存块的地址。 此内存块必须通过调用 SCardFreeMemory解除分配。

输出时，此值表示 szProvider 变量中的实际字符数，包括 null 终止符。

返回值

此函数返回不同的值，具体取决于它是成功还是失败。

返回代码 描述
成功
 SCARD_S_SUCCESS。
故障
 错误代码。 有关详细信息，请参阅 智能卡返回值。

言论

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

成功完成此函数后，szProvider 中的值可用作调用 CryptAcquireContext中的第三个参数。

例子

以下示例演示如何检索指定读取器上下文的提供程序名称。 该示例假定 hContext 是从上一次调用 SCardEstablishContext 函数获取的有效句柄。

LPTSTR szProvider = NULL;
LPTSTR szCardName = _T("WindowsCard");
DWORD  chProvider = SCARD_AUTOALLOCATE;
LONG   lReturn = SCARD_S_SUCCESS;

// Retrieve the provider name.
// hContext was set by SCardEstablishContext.
lReturn = SCardGetCardTypeProviderName(hContext,
                                       szCardName,
                                       SCARD_PROVIDER_CSP,
                                       (LPTSTR)&szProvider,
                                       &chProvider);
if (SCARD_S_SUCCESS == lReturn)
{
    BOOL fSts = TRUE;
    HCRYPTPROV hProv = NULL;
  
  // Acquire a Cryptographic operation context.
    fSts = CryptAcquireContext(&hProv,
                               NULL,
                               szProvider,
                               PROV_RSA_FULL,
                               0);
    // Perform Cryptographic operations with smart card
    // ...

    // Free memory allocated by SCardGetCardTypeProviderName.
    lReturn = SCardFreeMemory(hContext, szProvider);
}

注意

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

要求

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

另请参阅

SCardEstablishContext

SCardFreeMemory

SCardSetCardTypeProviderName