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

  • Статья

Открывает рабочий стол, который получает данные, введенные пользователем.

Синтаксис

HDESK OpenInputDesktop(
  [in] DWORD       dwFlags,
  [in] BOOL        fInherit,
  [in] ACCESS_MASK dwDesiredAccess
);

Параметры

[in] dwFlags

Этот параметр может быть равен нулю или следующему значению.

Значение Значение
DF_ALLOWOTHERACCOUNTHOOK
0x0001
 Позволяет процессам, запущенным в других учетных записях на рабочем столе, устанавливать перехватчики в этом процессе.

[in] fInherit

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

[in] dwDesiredAccess

Доступ к рабочему столу. Список прав доступа см. в разделе Безопасность рабочего стола и права доступа.

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

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

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

Комментарии

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

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

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

Если параметр dwDesiredAccess указывает READ_CONTROL, WRITE_DAC или WRITE_OWNER стандартные права доступа, необходимо также запросить права доступа DESKTOP_READOBJECTS и DESKTOP_WRITEOBJECTS .

Требования

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

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

CloseDesktop

Настольные системы

SetProcessWindowStation

SwitchDesktop

Функции оконных станций и настольных компьютеров