SCardListReadersWithDeviceInstanceIdW 函数 (winscard.h)
SCardListReadersWithDeviceInstanceId 函数获取已提供设备实例标识符的读取器列表。 此函数不会影响读取器的状态。
语法
LONG SCardListReadersWithDeviceInstanceIdW(
[in] SCARDCONTEXT hContext,
[in] LPCWSTR szDeviceInstanceId,
[out, optional] LPWSTR mszReaders,
[in, out] LPDWORD pcchReaders
);
参数
[in] hContext
标识查询的资源管理器上下文的句柄。 可以通过上一次调用 SCardEstablishContext 函数来设置资源管理器上下文。 此参数不能 NULL。
[in] szDeviceInstanceId
读取器的设备实例 ID。 可以通过使用读取器名称调用 SCardGetReaderDeviceInstanceId 函数或通过从 DDK 调用 SetupDiGetDeviceInstanceId 函数来获取此值。
[out, optional] mszReaders
包含提供的设备实例标识符中的智能卡读卡器的多字符串。 如果此值 NULL,则该函数将忽略 pcchReaders 参数中提供的缓冲区长度,如果此参数尚未 NULL,则将返回的缓冲区长度写入 pcchReaders,并返回成功代码。
[in, out] pcchReaders
mszReaders 缓冲区的长度(以字符为单位)。 此参数接收多字符串结构的实际长度,包括所有终止 null 字符。 如果将缓冲区长度指定为SCARD_AUTOALLOCATE,则 mszReaders 转换为指向字节指针的指针,并接收包含多字符串结构的内存块的地址。 使用此内存后,请使用 SCardFreeMemory 函数将其解除分配。
返回值
此函数返回不同的值,具体取决于它是成功还是失败。
返回代码 | 描述 |
---|---|
|
SCARD_S_SUCCESS。 |
|
错误代码。 有关详细信息,请参阅 智能卡返回值。 |
言论
此函数不会重定向。 当远程桌面会话内失败并出现SCARD_E_READER_UNAVAILABLE错误代码时,调用 SCardListReadersWithDeviceInstanceId 函数。
例子
szDeviceInstanceIdcchReaderNameLONG lReturn, lReturn2;
LPTSTR pmszReaders = NULL;
LPTSTR pReader = NULL;WCHAR
DWORD cchReaderName = SCARD_AUTOALLOCATE;
// Retrieve the reader’s name from it’s device instance ID
// hContext was set by a previous call to SCardEstablishContext.
// szDeviceInstanceId was obtained by calling SetupDiGetDeviceInstanceId
lReturn = SCardListReadersWithDeviceInstanceId (hContext,
szDeviceInstanceId,
(LPTSTR)&pmszReaders,
&cchReaderName);
switch( lReturn )
{
case SCARD_E_NO_READERS_AVAILABLE:
printf("No readers have the provided device instance ID.\n");
// Take appropriate action.
// ...
break;
case SCARD_S_SUCCESS:
// Do something with the multi string of readers.
// Output the values.
// A double-null terminates the list of values.
pReader = pmszReaders;
while ( '\0' != *pReader )
{
// Display the value.
printf("Reader: %S\n", pReader );
// Advance to the next value.
pReader = pReader + wcslen((wchar_t *)pReader) + 1;
}
// Free the memory.
lReturn2 = SCardFreeMemory( hContext,
pmszReaders );
if ( SCARD_S_SUCCESS != lReturn2 )
printf("Failed SCardFreeMemory\n");
break;
default:
printf("Failed SCardListReaders\n");
// Take appropriate action.
// ...
break;
注意
winscard.h 标头将 SCardListReadersWithDeviceInstanceId 定义为别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息,请参阅函数原型的
要求
要求 | 价值 |
---|---|
最低支持的客户端 | Windows 8 [仅限桌面应用] |
支持的最低服务器 | Windows Server 2012 [仅限桌面应用] |
目标平台 | 窗户 |
标头 | winscard.h |