XTSOLsetResUID

- set the UID associated with a window, a pixmap, or a colormap

Synopsis

cc [flag...] file... -lX11 -lXtsol [library...]
#include <X11/extensions/Xtsol.h>

Status XTSOLsetResUID(display, object, type, uidp);

Display *display;
XID object;
ResourceType type;
uid_t *uidp;

Parameters

display

Specifies a pointer to the Display structure; returned from XOpenDisplay().

object

Specifies the ID of a window system object whose UID you want to change. Possible window system objects are windows and pixmaps.

type

Specifies what type of resource is being accessed. Possible values are: IsWindow and IsPixmap.

uidp

Specifies a pointer to a uid_t structure that contains a UID.

Description

The client must have the PRIV_WIN_DAC_WRITE and PRIV_WIN_MAC_WRITE privileges. The XTSOLsetResUID() function changes the ownership of a window system object. This allows a client to create an object and then change its ownership. The new owner can then make modifications on this object as this object being created by itself.

Return Values

None.

Errors

BadAccess

Lack of privilege.

BadWindow

Not a valid window.

BadPixmap

Not a valid pixmap.

BadValue

Not a valid type.

Attributes

See attributes(5) for descriptions of the following attributes:

See Also

libXtsol(3LIB), XTSOLgetResUID(3XTSOL), attributes(5)

Notes

The functionality described on this manual page is available only if the system is configured with Trusted Extensions.