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 |
|