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

Статья
08/28/2023

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

Синтаксис

BOOL SetUserObjectInformationA(
  [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. В противном случае приложение может вести себя непредсказуемо и быть более уязвимым для эксплойтов безопасности.

Значение

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 или Юникод этой функции на основе определения константы препроцессора ЮНИКОД. Использование псевдонима, не зависящий от кодирования, с кодом, который не является нейтральным для кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или времени выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования


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