Функция WTSQueryListenerConfigW (wtsapi32.h)

Статья
03/04/2024

Извлекает сведения о конфигурации для прослушивателя Служб удаленных рабочих столов.

Синтаксис

BOOL WTSQueryListenerConfigW(
  [in]  HANDLE              hServer,
  [in]  PVOID               pReserved,
  [in]  DWORD               Reserved,
  [in]  LPWSTR              pListenerName,
  [out] PWTSLISTENERCONFIGW pBuffer
);

Параметры

[in] hServer

Дескриптор сервера узла сеансов удаленных рабочих стола. Всегда присвойте этому параметру значение WTS_CURRENT_SERVER_HANDLE.

[in] pReserved

Этот параметр зарезервирован. Всегда присвойте этому параметру значение NULL.

[in] Reserved

Этот параметр зарезервирован. Всегда устанавливайте для этого параметра нулевое значение.

[in] pListenerName

Указатель на строку, завершающуюся нулевым значением, которая содержит имя прослушивателя для запроса.

[out] pBuffer

Указатель на структуру WTSLISTENERCONFIG , которая получает полученные сведения о конфигурации прослушивателя.

Возвращаемое значение

Если функция выполняется успешно, возвращаемое значение будет ненулевым.

Если функция выполняется неудачно, возвращается нулевое значение. Чтобы получить расширенные сведения об ошибке, вызовите функцию GetLastError .

Заголовок wtsapi32.h определяет WTSQueryListenerConfig в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование	Значение
Минимальная версия клиента	Windows 7
Минимальная версия сервера	Windows Server 2008 R2
Целевая платформа	Windows
Header	wtsapi32.h
Библиотека	Wtsapi32.lib
DLL	Wtsapi32.dll

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

WTSGetListenerSecurity

WTSLISTENERCONFIG

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