Функция OpenWindowStationA (winuser.h)
Открывает указанную станцию окон.
Синтаксис
HWINSTA OpenWindowStationA(
[in] LPCSTR lpszWinSta,
[in] BOOL fInherit,
[in] ACCESS_MASK dwDesiredAccess
);
Параметры
[in] lpszWinSta
Имя открываемой станции окна. Имена станций окон не учитывает регистр.
Эта станция окон должна принадлежать текущему сеансу.
[in] fInherit
Если это значение TRUE, процессы, созданные этим процессом, наследуют дескриптор. В противном случае процессы не наследуют этот дескриптор.
[in] dwDesiredAccess
Доступ к станции окон. Список прав доступа см. в разделе Windows Station Security and Access Rights.
Возвращаемое значение
Если функция выполнена успешно, возвращаемое значение является дескриптором указанной станции окон.
Если функция завершается ошибкой, возвращаемое значение равно NULL. Чтобы получить расширенные сведения об ошибке, вызовите GetLastError.
Замечания
После завершения работы с дескриптором необходимо вызвать CloseWindowStation, чтобы освободить дескриптор.
Заметка
Заголовок winuser.h определяет OpenWindowStation как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Windows 2000 Профессиональный [только классические приложения] |
| минимальный поддерживаемый сервер | Windows 2000 Server [только классические приложения] |
| целевая платформа | Виндоус |
| заголовка | winuser.h (включая Windows.h) |
| библиотеки |
User32.lib |
| DLL | User32.dll |
| набор API | ext-ms-win-ntuser-windowstation-ansi-l1-1-1 (представлено в Windows 10 версии 10.0.14393) |
См. также
станции окон