通过

SCardGetReaderDeviceInstanceIdW 函数 （winscard.h）

  • 项目

SCardGetReaderDeviceInstanceId 函数获取给定读卡器名称的设备实例标识符。 此函数不会影响读取器的状态。

语法

LONG SCardGetReaderDeviceInstanceIdW(
  [in]            SCARDCONTEXT hContext,
  [in]            LPCWSTR      szReaderName,
  [out, optional] LPWSTR       szDeviceInstanceId,
  [in, out]       LPDWORD      pcchDeviceInstanceId
);

参数

[in] hContext

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

[in] szReaderName

读取者名称。 可以通过调用 SCardListReaders 函数来获取此值。

[out, optional] szDeviceInstanceId

接收读取器设备实例 ID 的缓冲区。 如果此值 NULL，则该函数将忽略 cchDeviceInstanceId 参数中提供的缓冲区长度，如果此参数尚未 NULL，则将返回的缓冲区长度写入 cchDeviceInstanceId，并返回成功代码。

[in, out] pcchDeviceInstanceId

szDeviceInstanceId 缓冲区的长度（以字符为单位）包括 NULL 终止符。 如果将缓冲区长度指定为SCARD_AUTOALLOCATE，则 szDeviceInstanceId 参数将转换为指向字节指针的指针，并接收包含实例 ID 的内存块的地址。此内存块必须与 SCardFreeMemory 函数解除分配。

返回值

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

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

言论

此函数不会重定向。 在远程桌面会话内失败并出现SCARD_E_READER_UNAVAILABLE错误代码时调用 SCardGetReaderDeviceInstanceId 函数。

例子


LONG     lReturn;
LPTSTR   szReaderName = "USB Smart Card Reader 0";
WCHAR    szDeviceInstanceId[256];
DWORD    cchDeviceInstanceId = 256;

// Retrieve the reader's device instance ID.
// hContext was set by a previous call to SCardEstablishContext.
lReturn = SCardGetReaderDeviceInstanceId (hContext,
                         szReaderName,
                         szDeviceInstanceId,
                         &cchDeviceInstanceId);

if ( SCARD_S_SUCCESS != lReturn )
{
    printf("Failed SCardGetReaderDeviceInstanceId - %x\n", lReturn);
    // Take appropriate action.
}

注意

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

要求

要求 价值
最低支持的客户端 Windows 8 [仅限桌面应用]
支持的最低服务器 Windows Server 2012 [仅限桌面应用]
目标平台 窗户
标头 winscard.h