SCardGetCardTypeProviderNameW 函数 (winscard.h)

  • 项目

SCardGetCardTypeProviderName 函数返回模块的名称 (动态链接库) ，其中包含给定卡名称和提供程序类型的提供程序。

语法

LONG SCardGetCardTypeProviderNameW(
  [in]      SCARDCONTEXT hContext,
  [in]      LPCWSTR      szCardName,
  [in]      DWORD        dwProviderId,
  [out]     WCHAR        *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 终止符。

返回值

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

返回代码 说明
Success
 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 [仅限桌面应用]
目标平台 Windows
标头 winscard.h
Library Winscard.lib
DLL Winscard.dll

另请参阅

SCardEstablishContext

SCardFreeMemory

SCardSetCardTypeProviderName