The GetUserObjectInformation function returns information about a window station or desktop object.
BOOL GetUserObjectInformation(
HANDLE hObj, // handle to object to get information for
int nIndex, // type of information to retrieve
PVOID pvInfo, // points to buffer that receives the information
DWORD nLength, // size of the pvInfo buffer
LPDWORD lpnLengthNeeded // receives required size of the pvInfo buffer
);
Value | Description |
---|---|
UOI_FLAGS | Returns handle flags. The pvInfo parameter must point to a USEROBJECTFLAGS structure. |
UOI_NAME | Returns a string containing the name of the object. |
UOI_TYPE | Returns a string containing the type name of the object. |
UOI_USER_SID | Returns the SID structure that identifies the user that is currently associated with the specified object. If no user is associated with the object, the value returned in the buffer pointed to by lpnLengthNeeded is zero. Note that SID is a variable length structure. You will usually make a call to GetUserObjectInformation to determine the length of the SID before retrieving its value. |
If the function succeeds, the return value is nonzero.
If the function fails, the return value is zero. To get extended error information, call GetLastError.
Windows NT: Requires version 3.51 or later.
Windows: Unsupported.
Windows CE: Unsupported.
Header: Declared in winuser.h.
Import Library: Use user32.lib.
Unicode: Implemented as Unicode and ANSI versions on Windows NT.
Window Stations and Desktops Overview, Window Station and Desktop Functions, CreateDesktop, CreateWindowStation, GetUserObjectSecurity, OpenDesktop, OpenWindowStation, SetUserObjectInformation, SetUserObjectSecurity, SID, USEROBJECTFLAGS