opensolaris man page for xtsolsetpropuid

XTSOLsetPropUID(3XTSOL) 			 Trusted Extensions to X Windows Library Functions			   XTSOLsetPropUID(3XTSOL)

NAME
       XTSOLsetPropUID - set the UID associated with a property hanging on a window

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

       Status XTSOLsetPropUID(display, window, property, uidp);

       Display *display;
       Window window;
       Atom property;
       uid_t *uidp;

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

       window	   Specifies the ID of the window whose property's UID you want to change.

       property    Specifies the property atom.

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

DESCRIPTION
       The  XTSOLsetPropUID()  function  changes the ownership of a window's property. This allows another client to modify a property of a window
       that it did not create. The client must have the PRIV_WIN_DAC_WRITE and PRIV_WIN_MAC_WRITE privileges.

RETURN VALUES
       None.

ERRORS
       BadAccess    Lack of privilege.

       BadWindow    Not a valid window.

       BadAtom	    Not a valid atom.

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

       +---------------------------+-------------------------------+
       |      ATTRIBUTE TYPE	   |	    ATTRIBUTE VALUE	   |
       +---------------------------+-------------------------------+
       |Interface Stability	   | Committed			   |
       +---------------------------+-------------------------------+
       |MT-Level		   | Unsafe			   |
       +---------------------------+-------------------------------+

SEE ALSO
       libXtsol(3LIB), XTSOLgetPropAttributes(3XTSOL), XTSOLgetPropUID(3XTSOL), attributes(5)

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

SunOS 5.11							    20 Jul 2007 					   XTSOLsetPropUID(3XTSOL)