На главную

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 | Скачать Вниз

CreateWindowStation



The CreateWindowStation function creates a window station object. It returns a handle that can be used to access the window station. A window station is a secure object that contains a set of global atoms, a clipboard, and a set of desktop objects.

HWINSTA CreateWindowStation(

LPTSTR lpwinsta, // name of the new window station
DWORD dwReserved, // reserved; must be NULL
DWORD dwDesiredAccess, // specifies access of returned handle
LPSECURITY_ATTRIBUTES lpsa // specifies security attributes of the window station
);


Parameters

lpwinsta

Optionally points to a null-terminated string specifying the name of the window station to be created. Window station names are case-insensitive and cannot contain backslash characters (\). Only members of the Administrators group are allowed to specify a name. If lpwinsta is NULL, the system forms a window station name using the logon session identifier for the calling process. To get this name, call the GetUserObjectInformation function.

dwReserved

Reserved; must be NULL.

dwDesiredAccess

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

Value Description
WINSTA_ACCESSCLIPBOARD Required to use the clipboard.
WINSTA_ACCESSGLOBALATOMS Required to manipulate global atoms.
WINSTA_CREATEDESKTOP Required to create new desktop objects on the window station.
WINSTA_ENUMDESKTOPS Required to enumerate existing desktop objects.
WINSTA_ENUMERATE Required for the window station to be enumerated.
WINSTA_EXITWINDOWS Required to successfully call the ExitWindows or ExitWindowsEx functions.
WINSTA_READATTRIBUTES Required to read the attributes of a window station object.
WINSTA_READSCREEN Required to access screen contents.
WINSTA_WRITEATTRIBUTES Required to modify the attributes of a window station object.


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 window station. If lpsa is NULL, the window station (and any desktops created within the window) gets a security descriptor that grants GENERIC_ALL access to all users.
Windows 95: The lpSecurityDescriptor member of the structure is ignored.



Return Values

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

See Also

GetUserObjectInformation, OpenWindowStation


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

CreateWindowStation



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

HWINSTA CreateWindowStation(

LPTSTR lpwinsta, // ИМЯ новой станции окна DWORD dwReserved, // зарезервированное; должно быть NULL DWORD dwDesiredAccess, // определяет что доступ возвращанной ручки LPSECURITY_ATTRIBUTES lpsa // определяет атрибуты безопасности станции окна
);


Параметры

lpwinsta

Дополнительно точки на недействительный расторгнутую строку, определяющие имя станции окна, которое нужно создаваться. Имена станции Окна случай-нечувствительные и не могут содержать символы обратной косой черты (\). Только участники группы Администраторов позволены определять имя. Если lpwinsta НЕДЕЙСТВИТЕЛЬНО, система формирует имя станции окна, использовавшее сеансовый идентификатор ввода для вызова процесса. Для того, чтобы получать это имя, назовите функцию GetUserObjectInformation.

dwReserved

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

dwDesiredAccess

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

Описание Величины
WINSTA_ACCESSCLIPBOARD Требовавшийся, чтобы использовать планшет.
WINSTA_ACCESSGLOBALATOMS Требовавшийся, чтобы манипулировать глобальными атомами.
WINSTA_CREATEDESKTOP Требовавшийся, чтобы создавать новые настольные объекты на станции окна.
WINSTA_ENUMDESKTOPS Требовавшийся, чтобы перечислять настольные объекты существовать.
WINSTA_ENUMERATE Необходимый для станции окна, которая нужно перечисляться.
WINSTA_EXITWINDOWS Требовавшийся, чтобы успешно называть ExitWindows или функции ExitWindowsEx.
WINSTA_READATTRIBUTES Требовавшийся, чтобы читать атрибуты объекта станции окна.
WINSTA_READSCREEN Требовавшийся, чтобы иметь доступ к экранному содержанию.
WINSTA_WRITEATTRIBUTES Требовавшийся, чтобы модифицировать атрибуты объекта станции окна.


lpsa

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

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



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

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

Смотри Также

GetUserObjectInformation, OpenWindowStation


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