На главную

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

GetUserObjectInformation



The GetUserObjectInformation function returns information about a window station or desktop object.

BOOL GetUserObjectInformation(

HANDLE hObj, // handle of object to get information for
int nIndex, // type of information to get
PVOID pvInfo, // points to buffer that receives the information
DWORD nLength, // size, in bytes, of pvInfo buffer
LPDWORD lpnLengthNeeded // receives required size, in bytes, of pvInfo buffer
);


Parameters

hObj

Identifies the window station or desktop object for which to return information. This can be an HDESK or HWINSTA handle (for example, a handle returned by CreateWindowStation, OpenWindowStation, CreateDesktop, or OpenDesktop).

nIndex

Specifies the object information to be retrieved. The parameter must be one of the following values:

Value Description
UOI_FLAGS Returns handle flags. The pvInfo parameter must point to a USEROBJECTFLAGS structure.
UOI_NAME Returns a string containing the name of the object.
UOI_TYPE Returns a string containing the type name of the object.


pvInfo

Points to a buffer to receive the object information.

nLength

Specifies the size, in bytes, of the buffer pointed to by the pvInfo parameter.

lpnLengthNeeded

Points to a variable receiving the number of bytes required to store the requested information. If this variable's value is greater than the value of the nLength parameter when the function returns, the function returns FALSE, and none of the information is copied to the pvInfo buffer. If the value of the variable pointed to by lpnLengthNeeded is less than or equal to the value of nLength, the entire information block is copied.



Return Values

If the function succeeds, the return value is nonzero.
If the function fails, the return value is zero. To get extended error information, call GetLastError.

See Also

CreateDesktop, CreateWindowStation, GetUserObjectSecurity, OpenDesktop, OpenWindowStation, SetUserObjectInformation, SetUserObjectSecurity, USEROBJECTFLAGS


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

GetUserObjectInformation



Функция GetUserObjectInformation возвращает информации о станции окна или настольного объекта.

BOOL GetUserObjectInformation(

РУЧКА hObj, // ручка объекта против получать информацию для int nIndex, // типа информации, чтобы получать PVOID pvInfo, // точки, чтобы буферизовать, что получает информацию DWORD nLength, // размер, в байтах, буфера pvInfo LPDWORD lpnLengthNeeded // приемники требовали размер, в байтах, буфера pvInfo
);


Параметры

hObj

Идентифицирует станцию окна или настольного объекта для которых, чтобы возвращать информацию. Это может быть HDESK или ручкой HWINSTA (например, ручка возвращалась CreateWindowStation, OpenWindowStation, CreateDesktop, или OpenDesktop).

nIndex

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

Описание Величины
UOI_FLAGS Возвращает флаги ручки. Параметр pvInfo должен указать на структуру USEROBJECTFLAGS.
UOI_NAME Возвращает строку, содержащую имя объекта.
UOI_TYPE Возвращает строку, содержащую имя типа объекта.


pvInfo

Точки на буфер, чтобы получать объектную информацию.

nLength

Определяет размер, в байтах, буфера указанного, чтобы параметром pvInfo.

lpnLengthNeeded

Точки на переменную, получающие количество байтов требовавшихся, чтобы загружать запрошенную информацию. Если эта переменная величина больше, чем величина параметра nLength когда функция возвращается, функциональная ЛОЖЬ возврата, и ни одна из информации не скопирована в буфер pvInfo. Если величина переменной указанной, чтобы lpnLengthNeeded - менее чем или равный величине nLength, целый информационный блок скопирован.



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

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

Смотри Также

CreateDesktop, CreateWindowStation, GetUserObjectSecurity, OpenDesktop, OpenWindowStation, SetUserObjectInformation, SetUserObjectSecurity, USEROBJECTFLAGS


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