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
与此卡类型关联的提供程序的标识符。
值 | 含义 |
---|---|
|
函数检索智能卡的主要服务提供程序的名称作为 GUID 字符串。 |
|
函数检索 加密服务提供程序的名称。 |
|
函数检索智能卡密钥存储提供程序的名称 (KSP) 。 |
|
函数检索卡模块的名称。 |
[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 [仅限桌面应用] |
目标平台 | Windows |
标头 | winscard.h |
Library | Winscard.lib |
DLL | Winscard.dll |
另请参阅
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈