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

Функция EnumWindowStationsA (winuser.h)

  • Статья

Перечисляет все оконные станции в текущем сеансе. Функция, в свою очередь, передает имя каждой оконной станции в определяемую приложением функцию обратного вызова.

Синтаксис

BOOL EnumWindowStationsA(
  [in] WINSTAENUMPROCA lpEnumFunc,
  [in] LPARAM          lParam
);

Параметры

[in] lpEnumFunc

Указатель на определяемую приложением функцию обратного вызова EnumWindowStationProc .

[in] lParam

Определяемое приложением значение, передаваемое функции обратного вызова.

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

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

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

Если функция обратного вызова завершается сбоем, возвращаемое значение равно нулю. Функция обратного вызова может вызывать Метод SetLastError , чтобы задать код ошибки для получения вызывающего объекта путем вызова GetLastError.

Комментарии

Функция EnumWindowStations перечисляет только те оконные станции, для которых вызывающий процесс имеет право доступа к WINSTA_ENUMERATE. Дополнительные сведения см. в разделе Права на доступ и безопасность станции Windows.

EnumWindowStations неоднократно вызывает функцию обратного вызова lpEnumFunc , пока не будет перечислена последняя станция окна или функция обратного вызова не вернет значение FALSE.

Примечание

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

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header winuser.h (включая Windows.h)
Библиотека User32.lib
DLL User32.dll

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

EnumWindowStationProc

Функции Оконной станции и рабочего стола

Оконные станции