На главную

On-line справка по Win32 API

Написать письмо
БЕСПЛАТНАЯ ежедневная online лотерея! Выигрывай каждый день БЕСПЛАТНО!
Список всех статей A-B-C-D-E-F-G-H-I-J-K-L-M-N-O-P-Q-R-S-T-U-V-W-X-Y-Z | Скачать Вниз

CreateDesktop



The CreateDesktop function creates a new desktop on the window station associated with the calling process. It returns a handle that can be used to access the new desktop. The calling process must have an associated window station, either assigned by the system at process creation time or set by SetProcessWindowStation. A desktop is a secure object contained within a window station object. A desktop has a logical display surface and contains windows, menus, and hooks.

HDESK CreateDesktop(

LPCTSTR lpszDesktop, // name of the new desktop
LPCTSTR lpszDevice, // reserved; must be NULL.
LPDEVMODE pDevMode, // reserved; must be NULL
DWORD dwFlags, // flags to control interaction with other applications
DWORD dwDesiredAccess, // specifies access of returned handle
LPSECURITY_ATTRIBUTES lpsa // specifies security attributes of the desktop
);


Parameters

lpszDesktop

Points to a null-terminated string specifying the name of the desktop to be created. Desktop names are case-insensitive and may not contain backslash characters (\).

lpszDevice

Reserved; must be NULL. The desktop uses the default display driver loaded at boot time.

pDevMode

Reserved; must be NULL.

dwFlags

A bit flag parameter that controls how the calling application will cooperate with other applications on the desktop. This parameter can specify zero or the following value:

Value Description
DF_ALLOWOTHERACCOUNTHOOK Allows processes running in other accounts on the desktop to set hooks in this process.


dwDesiredAccess

Specifies the type of access to the desktop. This parameter can be one or more of the following values:

Value Description
DESKTOP_CREATEMENU Required to create a menu on the desktop.
DESKTOP_CREATEWINDOW Required to create a window on the desktop.
DESKTOP_ENUMERATE Required for the desktop to be enumerated.
DESKTOP_HOOKCONTROL Required to establish any of the window hooks.
DESKTOP_JOURNALPLAYBACK Required to perform journal playback on the desktop.
DESKTOP_JOURNALRECORD Required to perform journal recording on the desktop.
DESKTOP_READOBJECTS Required to read objects on the desktop.
DESKTOP_SWITCHDESKTOP Required to activate the desktop using the SwitchDesktop function.
DESKTOP_WRITEOBJECTS Required to write objects on the desktop.


lpsa

Pointer to a SECURITY_ATTRIBUTES structure that determines whether the returned handle can be inherited by child processes. If lpsa is NULL, the handle cannot be inherited.

Windows NT: The lpSecurityDescriptor member of the structure specifies a security descriptor for the new desktop. If lpsa is NULL, the desktop inherits its security descriptor from the parent window station.
Windows 95: The lpSecurityDescriptor member of the structure is ignored.



Return Values

If the function succeeds, the return value is a handle to the newly created desktop.
If the function fails, the return value is NULL. To get extended error information, call GetLastError.

Remarks

The CreateDesktop function returns a handle that can be used to access the desktop.

See Also

SECURITY_ATTRIBUTES, SetProcessWindowStation, SwitchDesktop


Пригласи друзей и счет твоего мобильника всегда будет положительным!
Предыдущая статья
 
Сайт Народ.Ру Интернет
Следующая статья
Пригласи друзей и счет твоего мобильника всегда будет положительным!

CreateDesktop



Функция CreateDesktop создает новую настольную систему на станции окна связанной вызовом процесса. Это возвращает ручку, которая может быть использована, чтобы иметь доступ к новой настольной системе. Вызов процесса должен иметь связанную станцию окна, или назначенное системой во времени создания процесса или установленное SetProcessWindowStation. Настольная система является безопасным объектом содержимым в пределах объекта станции окна. Настольная система имеет логический дисплей всплывать и содержит окно, меню и перехватывается.

HDESK CreateDesktop(

LPCTSTR lpszDesktop, // ИМЯ новой настольной системы LPCTSTR lpszDevice, // зарезервированное; должно быть НЕДЕЙСТВИТЕЛЬНО.
LPDEVMODE pDevMode, // ЗАРЕЗЕРВИРОВАННОЕ; должно быть NULL DWORD dwFlags, // флагами, чтобы управлять взаимодействием с другими приложениями DWORD dwDesiredAccess, // определяет что доступ возвращанной ручки LPSECURITY_ATTRIBUTES lpsa // определяет атрибуты безопасности настольной системы
);


Параметры

lpszDesktop

Точки на недействительный расторгнутую строку, определяющие имя настольной системы, которая нужно создаваться. Имена Desktop случай-нечувствительные и не могут содержать символы обратной косой черты (\).

lpszDevice

Зарезервированное; должно быть НЕДЕЙСТВИТЕЛЬНО. Настольная система использует по умолчанию дисплейный драйвер загруженный во времени загрузки.

pDevMode

Зарезервированное; должно быть НЕДЕЙСТВИТЕЛЬНО.

dwFlags

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

Описание Величины
DF_ALLOWOTHERACCOUNTHOOK Допускает процессы работая в других отчетностях в настольной системе, чтобы устанавливать захват в этом процессе.


dwDesiredAccess

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

Описание Величины
DESKTOP_CREATEMENU Требовавшийся, чтобы создавать меню в настольной системе.
DESKTOP_CREATEWINDOW Требовавшийся, чтобы создавать окно в настольной системе.
DESKTOP_ENUMERATE Необходимый для настольной системы, которая нужно перечисляться.
DESKTOP_HOOKCONTROL Требовавшийся, чтобы устанавливать любой из захвата окна.
DESKTOP_JOURNALPLAYBACK Требовавшийся, чтобы выполнять воспроизведение журнала в настольной системе.
DESKTOP_JOURNALRECORD Требовавшийся, чтобы выполнять журнал, записывающийся в настольную систему.
DESKTOP_READOBJECTS Требовавшийся, чтобы читать объекты в настольной системе.
DESKTOP_SWITCHDESKTOP Требовавшийся, чтобы активизировать настольную систему, использовавшую функцию SwitchDesktop.
DESKTOP_WRITEOBJECTS Требовавшийся, чтобы записывать объекты в настольную систему.


lpsa

Указатель в структуру SECURITY_ATTRIBUTES, которая определяет может возвращанная ручка быть унаследована процессами ребенка. Если lpsa НЕДЕЙСТВИТЕЛЬНО, ручка не может быть унаследована.

Windows NT: элемент lpSecurityDescriptor структуры определяет дескриптор безопасности для новой настольной системы. Если lpsa НЕДЕЙСТВИТЕЛЬНО, настольная система наследует свой дескриптор безопасности с родительской станции окна.
Windows 95: элемент lpSecurityDescriptor структуры проигнорирован.



Обратные Величины

Если функция добивается успеха, обратная величина является ручкой в вновь созданную настольную систему.
Если функция терпит неудачу, обратная величина НЕДЕЙСТВИТЕЛЬНА. Для того, чтобы расширять информацию ошибки, назовите GetLastError.

Замечания

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

Смотри Также

SECURITY_ATTRIBUTES, SetProcessWindowStation, SwitchDesktop


Вверх Version 1.3, Oct 26 2010 © 2007, 2010, mrhx Вверх
 mrhx software  Русский перевод OpenGL  Русский перевод Win32 API
 
Используются технологии uCoz