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

  • Статья

Открывает указанную станцию окон.

Синтаксис

HWINSTA OpenWindowStationA(
  [in] LPCSTR      lpszWinSta,
  [in] BOOL        fInherit,
  [in] ACCESS_MASK dwDesiredAccess
);

Параметры

[in] lpszWinSta

Имя открываемой оконной станции. Имена оконных станций не учитывают регистр.

Эта оконная станция должна принадлежать текущему сеансу.

[in] fInherit

Если это значение равно TRUE, процессы, созданные этим процессом, наследуют дескриптор. В противном случае процессы не наследуют этот дескриптор.

[in] dwDesiredAccess

Доступ к оконной станции. Список прав доступа см. в разделе Безопасность и права доступа на станцию Windows.

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

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

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

Комментарии

После завершения работы с дескриптором необходимо вызвать CloseWindowStation , чтобы освободить дескриптор.

Примечание

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

Требования

   
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header winuser.h (включая Windows.h)
Библиотека User32.lib
DLL User32.dll
Набор API ext-ms-win-ntuser-windowstation-ansi-l1-1-1 (появилась в Windows 10 версии 10.0.14393)

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

CloseWindowStation

ExitWindows

ExitWindowsEx

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

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