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

Статья
11/20/2024

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

Синтаксис

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

Параметры

[in] lpEnumFunc

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

[in] lParam

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

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

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

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

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

Замечания

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

EnumWindowStations многократно вызывает функцию обратного вызова lpEnumFunc до перечисления последней станции окон или функция обратного вызова возвращает ЗНАЧЕНИЕ FALSE.

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	winuser.h (включая Windows.h)
библиотеки	User32.lib
DLL	User32.dll

См. также

EnumWindowStationProc

станции окон оконных станций и рабочих столов

оконных станций

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