GetUserObjectInformation

【勇芳软件工作室】汉化HomePreviousNext

GetUserObjectInformation函数返回有关窗口站或桌面对象的信息。

BOOL GetUserObjectInformation(

HANDLE 【hObjhr】,//处理对象获取信息
INT 【参数nIndex】,//获取信息的类型
PVOID 【pvInfo】,//指向接收信息的缓冲区
DWORD 【nLength】,// size(以字节为单位)的【pvInfo】缓冲区
LPDWORD 【lpnLengthNeeded】//接收【pvInfo】缓冲区的所需大小(以字节为单位)
); 

参数

【hObjhr】

标识要返回信息的窗口台或桌面对象。这可以是HDESK或HWINSTA句柄(例如,CreateWindowStation OpenWindowStationCreateDesktopOpenDesktop)返回的句柄。

【参数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