GetUserObjectInformation函数返回有关窗口站或桌面对象的信息。
BOOL GetUserObjectInformation(
HANDLE 【hObjhr】, | //处理对象获取信息 |
INT 【参数nIndex】, | //获取信息的类型 |
PVOID 【pvInfo】, | //指向接收信息的缓冲区 |
DWORD 【nLength】, | // size(以字节为单位)的【pvInfo】缓冲区 |
LPDWORD 【lpnLengthNeeded】 | //接收【pvInfo】缓冲区的所需大小(以字节为单位) |
); |
参数
【hObjhr】
标识要返回信息的窗口台或桌面对象。这可以是HDESK或HWINSTA句柄(例如,CreateWindowStation OpenWindowStation,CreateDesktop或OpenDesktop)返回的句柄。
【参数nIndex】
指定要检索的对象信息。该参数必须是以下值之一:
值 | 描述 |
UOI_FLAGS | 返回句柄标志。【pvInfo】参数必须指向USEROBJECTFLAGS结构。 |
UOI_NAME | 返回一个包含对象名称的字符串。 |
UOI_TYPE | 返回一个包含对象类型名称的字符串。 |
【pvInfo】
指向缓冲区以接收对象信息。
【nLength】
指定【pvInfo】参数指向的缓冲区的大小(以字节为单位)。
【lpnLengthNeeded】
指向一个变量,接收存储所请求信息所需的字节数。如果该函数返回时该变量的值大于【nLength】参数的值,则函数返回FALSE,并且没有任何信息被复制到【pvInfo】缓冲区。如果【lpnLengthNeeded】指向的变量的值小于或等于【nLength】的值,则复制整个信息块。
返回值
如果函数成功,返回值不为零。
如果函数失败,返回值为零。要获取扩展错误信息,请调用GetLastError.
也可以看看
CreateDesktop, CreateWindowStation, GetUserObjectSecurity, OpenDesktop, OpenWindowStation, SetUserObjectInformation, SetUserObjectSecurity, USEROBJECTFLAGS