Функция TLSLicenseEnumBegin
Начинает перечисление лицензий, выданных сервером лицензирования удаленных рабочих столов на основе условий поиска.
Примечание
У этой функции нет связанного файла заголовка или библиотеки импорта. Чтобы вызвать эту функцию, необходимо создать определяемый пользователем файл заголовка и использовать функции LoadLibrary и GetProcAddress для динамического связывания с Mstlsapi.dll.
Синтаксис
DWORD WINAPI TLSLicenseEnumBegin(
_In_ TLS_HANDLE hHandle,
_In_ DWORD dwSearchParm,
_In_ BOOL bMatchAll,
_In_ LSLicense *lpSearchParm,
_Out_ PDWORD pdwErrCode
);
Параметры
-
hHandle [in]
-
Дескриптор на сервере лицензирования удаленных рабочих столов. Укажите дескриптор, который открывается функцией TLSConnectToLsServer .
-
dwSearchParm [in]
-
Указывает критерии поиска. Параметр может быть одним или сочетанием значений, описанных в следующем списке. Параметр указывает тип пакета ключей и пакет ключей для поиска.
-
LSLICENSE_SEARCH_LICENSEID (0x00000001)
-
Поиск по идентификатору лицензии.
-
LSLICENSE_SEARCH_KEYPACKID (0x00000002)
-
Поиск по идентификатору пакета ключей.
-
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 |
|