SCardListReaderGroupsA 函数 (winscard.h)
SCardListReaderGroups 函数提供以前引入系统的读取器组的列表。
语法
LONG SCardListReaderGroupsA(
[in] SCARDCONTEXT hContext,
[out] LPSTR mszGroups,
[in, out] LPDWORD pcchGroups
);
参数
[in] hContext
标识查询的 资源管理器上下文 的句柄。 资源管理器上下文可以通过之前调用 SCardEstablishContext 来设置。
如果此参数设置为 NULL,则搜索读取者组不限于任何上下文。
[out] mszGroups
多字符串,列出为系统定义并可供当前 终端上的当前用户使用的读取器组。 如果此值为 NULL,SCardListReaderGroups 将忽略 pcchGroups 中提供的缓冲区长度,写入如果此参数不是 pcchGroups的 NULL,将返回的缓冲区长度,并返回成功代码。
[in, out] pcchGroups
mszGroups 缓冲区的长度(以字符为单位),并接收多字符串结构的实际长度,包括所有尾随 null 字符。 如果将缓冲区长度指定为 SCARD_AUTOALLOCATE,则 mszGroups 将转换为指向字节指针的指针,并接收包含多字符串结构的内存块的地址。 此内存块必须与 SCardFreeMemory 一起解除分配。
返回值
此函数根据是成功还是失败返回不同的值。
返回代码 | 说明 |
---|---|
|
SCARD_S_SUCCESS。 |
|
错误代码。 有关详细信息,请参阅 智能卡返回值。 |
注解
仅当组包含至少一个 读取器时,才会返回该组。 这包括组 SCard$DefaultReaders。 无法返回 组 SCard$AllReaders ,因为它仅隐式存在。
SCardListReaderGroups 函数是数据库查询函数。 有关其他数据库查询函数的详细信息,请参阅 智能卡数据库查询函数。
示例
以下示例显示列出读取器组。
LPTSTR pmszReaderGroups = NULL;
LPTSTR pReaderGroup;
LONG lReturn;
DWORD cch = SCARD_AUTOALLOCATE;
// Retrieve the list the reader groups.
// hSC was set by a previous call to SCardEstablishContext.
lReturn = SCardListReaderGroups(hSC,
(LPTSTR)&pmszReaderGroups,
&cch );
if ( SCARD_S_SUCCESS != lReturn )
printf("Failed SCardListReaderGroups\n");
else
{
// Do something with the multi string of reader groups.
// Output the values.
// A double-null terminates the list of values.
pReaderGroup = pmszReaderGroups;
while ( '\0' != *pReaderGroup )
{
// Display the value.
printf("%S\n", pReaderGroup );
// Advance to the next value.
pReaderGroup = pReaderGroup + wcslen((wchar_t *) pReaderGroup) + 1;
}
// Remember to free pmszReaderGroups by a call to SCardFreeMemory.
// ...
}
注意
winscard.h 标头将 SCardListReaderGroups 定义为别名,该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。 将非特定编码别名的使用与非非特定编码的代码混合使用可能会导致不匹配,从而导致编译或运行时错误。 有关详细信息,请参阅 函数原型的约定。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | Windows XP [仅限桌面应用] |
最低受支持的服务器 | Windows Server 2003 [仅限桌面应用] |
目标平台 | Windows |
标头 | winscard.h |
Library | Winscard.lib |
DLL | Winscard.dll |