SCardListReadersA 函数 (winscard.h)
调用方提供读取器组的列表,并接收命名组中的读取器列表。 忽略无法识别的组名称。 此函数仅返回当前附加到系统的命名组中的读取器,并可供使用。
语法
LONG SCardListReadersA(
[in] SCARDCONTEXT hContext,
[in, optional] LPCSTR mszGroups,
[out] LPSTR mszReaders,
[in, out] LPDWORD pcchReaders
);
参数
[in] hContext
标识查询 资源管理器上下文 的句柄。 可以通过上一次调用 SCardEstablishContext来设置资源管理器上下文。
如果此参数设置为 NULL,则搜索读取器不限于任何上下文。
[in, optional] mszGroups
定义为系统的读取器组的名称,作为多字符串。 使用 NULL 值列出系统中的所有读取器(即 SCard$AllReaders 组)。
[out] mszReaders
多字符串,用于列出提供的读卡器组中的读卡器。 如果此值 NULL,SCardListReaders 将忽略 pcchReaders中提供的缓冲区长度,则将在此参数未 NULL写入 pcchReaders时返回的缓冲区长度,并返回成功代码。
[in, out] pcchReaders
mszReaders 缓冲区的长度(以字符为单位)。 此参数接收多字符串结构的实际长度,包括所有尾随 null 字符。 如果将缓冲区长度指定为SCARD_AUTOALLOCATE,则 mszReaders 转换为指向字节指针的指针,并接收包含多字符串结构的内存块的地址。 此内存块必须与 SCardFreeMemory解除分配。
返回值
此函数返回不同的值,具体取决于它是成功还是失败。
返回代码/值 | 描述 |
---|---|
|
SCARD_S_SUCCESS |
|
SCARD_E_NO_READERS_AVAILABLE |
|
SCARD_E_READER_UNAVAILABLE |
|
错误代码。 有关详细信息,请参阅 智能卡返回值。 |
言论
SCardListReaders 函数是数据库查询函数。 有关其他数据库查询函数的详细信息,请参阅 智能卡数据库查询函数。
例子
以下示例显示列出读取者。
LPTSTR pmszReaders = NULL;
LPTSTR pReader;
LONG lReturn, lReturn2;
DWORD cch = SCARD_AUTOALLOCATE;
// Retrieve the list the readers.
// hSC was set by a previous call to SCardEstablishContext.
lReturn = SCardListReaders(hSC,
NULL,
(LPTSTR)&pmszReaders,
&cch );
switch( lReturn )
{
case SCARD_E_NO_READERS_AVAILABLE:
printf("Reader is not in groups.\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( hSC,
pmszReaders );
if ( SCARD_S_SUCCESS != lReturn2 )
printf("Failed SCardFreeMemory\n");
break;
default:
printf("Failed SCardListReaders\n");
// Take appropriate action.
// ...
break;
}
注意
winscard.h 标头将 SCardListReaders 定义为一个别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。 有关详细信息,请参阅函数原型的
要求
要求 | 价值 |
---|---|
最低支持的客户端 | Windows XP [仅限桌面应用] |
支持的最低服务器 | Windows Server 2003 [仅限桌面应用] |
目标平台 | 窗户 |
标头 | winscard.h |
库 | Winscard.lib |
DLL | Winscard.dll |