SCardGetProviderIdA 函数 (winscard.h)

项目
08/27/2023

SCardGetProviderId 函数返回给定卡的主要服务提供商的标识符 (GUID) 。

调用方提供以前引入系统 ) 的智能卡 (的名称，并接收主要服务提供商 GUID 的已注册标识符（如果存在）。

语法

LONG SCardGetProviderIdA(
  [in]  SCARDCONTEXT hContext,
  [in]  LPCSTR       szCard,
  [out] LPGUID       pguidProviderId
);

参数

[in] hContext

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

[in] szCard

为系统定义的卡的名称。

[out] pguidProviderId

主要服务提供程序的标识符 (GUID) 。此提供程序可以使用 COM 激活，并将提供对卡中其他服务的访问权限。

返回值

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

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

注解

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

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

示例

以下示例演示如何获取指定卡的提供程序 ID。该示例假定 hContext 是从之前调用 SCardEstablishContext 函数获取的有效句柄，并且“MyCardName”是由之前对 SCardIntroduceCardType 函数的调用引入的。

GUID    guidProv;
LONG    lReturn;

lReturn = SCardGetProviderId(hContext, 
                             L"MyCardName",
                             &guidProv);
if ( SCARD_S_SUCCESS != lReturn )
    printf("Failed SCardGetProviderId - %x\n", lReturn);
else
{
    // Use the provider GUID as needed.
    // ...
}

注意

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

要求


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