Функция TLSKeyPackEnumBegin

Статья
06/13/2023

Начинает перечисление всех пакетов ключей, установленных на сервере лицензирования удаленных рабочих столов, на основе условий поиска.

Примечание

У этой функции нет связанного файла заголовка или библиотеки импорта. Чтобы вызвать эту функцию, необходимо создать определяемый пользователем файл заголовка и использовать функции LoadLibrary и GetProcAddress для динамического связывания с Mstlsapi.dll.

Синтаксис

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

Параметры

hHandle [in]: Дескриптор на сервере лицензирования удаленных рабочих столов. Укажите дескриптор, который открывается функцией TLSConnectToLsServer .
dwSearchParm [in]: Указывает критерии поиска. Этот параметр зарезервирован для использования в будущем и должен содержать 0xFFFFFFFF.
bMatchAll [in]: Указывает, должны ли совпадать все значения поиска.
lpSearchParm [in]: Указатель на структуру LSKeyPack , которая задает параметры поиска для поиска.
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

См. также раздел

LSKeyPack
TLSConnectToLsServer
TLSKeyPackEnumNext
TLSKeyPackEnumEnd

Поделиться через