通过

TLSLicenseEnumBegin 函数

  • 项目

开始枚举远程桌面许可证服务器基于搜索条件颁发的许可证。

注意

此函数没有关联的头文件或导入库。 若要调用此函数，必须创建用户定义的头文件，并使用 LoadLibrary 和 GetProcAddress 函数动态链接到Mstlsapi.dll。

语法

DWORD WINAPI TLSLicenseEnumBegin(
  _In_  TLS_HANDLE hHandle,
  _In_  DWORD      dwSearchParm,
  _In_  BOOL       bMatchAll,
  _In_  LSLicense  *lpSearchParm,
  _Out_ PDWORD     pdwErrCode
);

parameters

hHandle [in]

远程桌面许可证服务器的句柄。 指定由 TLSConnectToLsServer 函数打开的句柄。

dwSearchParm [in]

指定搜索条件。 参数可以是以下列表中所述的值的一个或组合。 参数指定密钥包的类型以及要搜索的密钥包。

LSLICENSE_SEARCH_LICENSEID (0x00000001)

按许可证 ID 搜索。

LSLICENSE_SEARCH_KEYPACKID (0x00000002)

按密钥包 ID 搜索。

LSLICENSE_SEARCH_MACHINENAME (0x00000008)

按计算机名称搜索。

LSLICENSE_SEARCH_USERNAME (0x00000010)

按用户名搜索。

LSLICENSE_SEARCH_ISSUEDATE (0x00000080)

按发行日期搜索。

LSLICENSE_SEARCH_EXPIREDATE (0x00000100)

按到期日期搜索。

LSLICENSE_SEARCH_ NUMLICENSES (0x00000200)

按许可证数搜索。

LSLICENSE_SEARCH_ ENTRY_STATUS (0x20000000)

按条目状态搜索。

LSLICENSE_EXSEARCH_LICENSESTATUS (0x00100000)

按许可证状态搜索。

LSKEYPACK_SEARCH_ALL (0xFFFFFFFF)

搜索所有许可证。

bMatchAll [in]

指定是否匹配所有搜索值。

lpSearchParm [in]

指向 LSLicense 结构的指针，该结构指定要查找的搜索参数。

pdwErrCode [out]

指向返回时接收以下错误代码之一的变量的指针。

LSERVER_S_SUCCESS (0)

调用成功。

LSERVER_E_INTERNAL_ERROR (5001)

许可证服务器中的内部错误。

LSERVER_E_INVALID_SEQUENCE (5006)

调用序列无效。 前一个枚举很可能尚未结束。

LSERVER_E_SERVER_BUSY (5007)

许可证服务器太忙，无法处理请求。

LSERVER_E_OUTOFMEMORY (5008)

由于内存不足，无法处理请求。

LSERVER_E_INVALID_DATA (5009)

搜索参数中的数据无效。

返回值

此函数返回以下可能的返回值。

RPC_S_OK

调用成功。 检查 pdwErrCode 参数的值以获取调用的返回代码。

RPC_S_INVALID_ARG

参数无效。

要求

要求 值
最低受支持的客户端
 Windows Vista
最低受支持的服务器
 Windows Server 2008
DLL
Mstlsapi.dll

请参阅

LSLicense

TLSConnectToLsServer

TLSLicenseEnumNext

TLSLicenseEnumEnd