Поделиться через


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

Задает сведения о указанной оконной станции или объекте desktop.

Синтаксис

BOOL SetUserObjectInformationW(
  [in] HANDLE hObj,
  [in] int    nIndex,
  [in] PVOID  pvInfo,
  [in] DWORD  nLength
);

Параметры

[in] hObj

Дескриптор оконной станции, настольного объекта или псевдо дескриптора текущего процесса. Этот дескриптор может быть возвращен функцией CreateWindowStation, OpenWindowStation, CreateDesktop, OpenDesktop или GetCurrentProcess .

[in] nIndex

Устанавливаемая информация об объекте. Этот параметр может иметь следующее значение.

Значение Значение
UOI_FLAGS
1
Задает флаги дескрипторов объекта. Параметр pvInfo должен указывать на структуру USEROBJECTFLAGS .
UOI_TIMERPROC_EXCEPTION_SUPPRESSION
7
Задает поведение обработки исключений при вызове TimerProc. hObj должен быть дескриптором процесса, возвращаемым функцией GetCurrentProcess .

Параметр pvInfo должен указывать на BOOL. Если задано значение TRUE, Windows заключает свои вызовы в TimerProc с обработчиком исключений, который использует и отменяет все исключения. Это поведение по умолчанию с Windows 2000, хотя это может измениться в будущих версиях Windows.

Если pvInfo указывает на FALSE, Windows не будет заключать свои вызовы в TimerProc с обработчиком исключений. Рекомендуется задать значение FALSE. В противном случае приложение может вести себя непредсказуемо и быть более уязвимым для эксплойтов безопасности.

[in] pvInfo

Указатель на буфер, содержащий сведения об объекте, или boOL.

[in] nLength

Размер сведений, содержащихся в буфере, на который указывает pvInfo, в байтах.

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

Если функция выполняется успешно, возвращается ненулевое значение.

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

Комментарии

Примечание

Заголовок winuser.h определяет SetUserObjectInformation в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header winuser.h (включая Windows.h)
Библиотека User32.lib
DLL User32.dll

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

CreateDesktop

CreateWindowStation

GetUserObjectInformation

OpenDesktop

OpenWindowStation

USEROBJECTFLAGS

Функции Оконной станции и рабочего стола

Оконные станции