SetUserObjectInformation

The SetUserObjectInformation function sets information about a window station or desktop object.

BOOL SetUserObjectInformation(
  HANDLE hObj,  // handle to the object for which to set information
  int nIndex,   // type of information to set
  PVOID pvInfo, // pointer to a buffer that contains the information
  DWORD nLength // size, in bytes, of pvInfo buffer
);
 

Parameters

hObj

Handle to the window station or desktop object for which to set object information. This value can be an HDESK or HWINSTA handle (for example, a handle returned by CreateWindowStation, OpenWindowStation, CreateDesktop, or OpenDesktop).

nIndex

Specifies the object information to be set. This parameter must specify the following value:

Value	Description
UOI_FLAGS	Sets the object's handle flags. The pvInfo parameter must point to a USEROBJECTFLAGS structure.

pvInfo

Pointer to a buffer containing the object information.

nLength

Specifies the size, in bytes, of the information contained in the buffer pointed to by pvInfo.

Return Values

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.

QuickInfo

  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.

See Also

Window Stations and Desktops Overview, Window Station and Desktop Functions, CreateDesktop, CreateWindowStation, GetUserObjectInformation, OpenDesktop,.OpenWindowStation, USEROBJECTFLAGS