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

Статья
11/20/2024

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

Синтаксис

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 должен указывать на ЛОГИЧЕСКОЕ значение. Если значение 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 должен указывать на ЛОГИЧЕСКОЕ значение. Если значение TRUE, Windows заключит вызовы TimerProc с обработчиком исключений, который потребляет и удаляет все исключения. Это поведение по умолчанию с Windows 2000, хотя это может измениться в будущих версиях Windows.

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

[in] pvInfo

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

[in] nLength

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

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

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

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

Замечания

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 2000 Профессиональный [только классические приложения]
минимальный поддерживаемый сервер	Windows 2000 Server [только классические приложения]
целевая платформа	Виндоус
заголовка	winuser.h (включая Windows.h)
библиотеки	User32.lib
DLL	User32.dll