Функция OpenInputDesktop (winuser.h)
Открывает рабочий стол, который получает данные, введенные пользователем.
Синтаксис
HDESK OpenInputDesktop(
[in] DWORD dwFlags,
[in] BOOL fInherit,
[in] ACCESS_MASK dwDesiredAccess
);
Параметры
[in] dwFlags
Этот параметр может быть равен нулю или следующему значению.
Значение | Значение |
---|---|
|
Позволяет процессам, запущенным в других учетных записях на рабочем столе, устанавливать перехватчики в этом процессе. |
[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) |