注意:这是Microsoft Windows的将来版本中将支持的技术的初步文档。
LSEnumProviders函数为每个已安装的许可证系统服务提供程序返回唯一的字符串。
LS_STATUS_CODE LS_API_ENTRY LSEnumProviders(
LS_ULONG 【指数】, | //服务提供商的索引 |
LS_STR 【*缓冲】 | //指向服务提供商的字符串指针 |
); |
参数
【指数】
[in]指定服务提供商的索引。第一个提供者的索引为零,第二个索引为1,依此类推。每个连续调用LSEnumProviders,呼叫者应该增加该索引,直到它返回LS_BAD_INDEX状态码。
【缓冲】
[out]指向要放置标识许可证系统服务提供商的唯一以空值终止的字符串的缓冲区。【缓冲】参数指向的缓冲区长度必须至少为255个字节。LS_ANY的值表示当前索引未使用,但不是要获取的最后一个索引。
返回值
如果函数成功,返回值为LS_SUCCESS。
如果函数失败,则返回值为状态码。有关扩展错误信息,请调用LSGetMessage 返回与状态【码】相对应的状态【文本】.LSGetMessage功能可能会返回以下状态代码之一:
值 | 含义 |
LS_BAD_INDEX | 在LSEnumProviders或LSQuery 功能的调用中指定了无效的索引。 |
LS_BUFFER_TOO_SMALL | 【缓冲】参数指向的缓冲区太小,无法容纳要返回的文本字符串;或挑战数据结构太小而不能应对挑战响应。 |
备注
LSEnumProviders函数为每个已安装的提供程序返回唯一的字符串。唯一以空值终止的字符串通常标识许可证系统的供应商,产品和版本。该值与通过适当调用LSQuery 函数返回的值相同。在网络环境中,它返回客户端的版本,而不是服务器。
应用程序可以依次调用LSEnumProviders来枚举已安装的许可证系统服务提供商。传入【指数】参数中指定的值,并且调用应用程序应在每个调用中增加它,直到它返回LS_BAD_INDEX状态代码。此代码表示【指数】参数的值高于当前安装的提供者数。
也可以看看