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 参数必须指向 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 定义为一个别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。将中性编码别名与不中性编码的代码混合使用可能会导致编译或运行时错误不匹配。有关详细信息，请参阅函数原型的约定。

要求

要求	价值
最低支持的客户端	Windows 2000 Professional [仅限桌面应用]
支持的最低服务器	Windows 2000 Server [仅限桌面应用]
目标平台	窗户
标头	winuser.h （包括 Windows.h）
库	User32.lib
DLL	User32.dll