opensolaris man page for xtsolgetpropuid

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

NAME
       XTSOLgetPropUID - get the UID associated with a property hanging on a window

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

       Status XTSOLgetPropUID (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 get.

       property    Specifies the property atom.

       uidp	   Returns  a  UID which is the current UID of the specified property. Client needs to provide a uid_t type storage and passes the
		   address of this storage as the function argument. Client must provide a pointer to uid_t.

DESCRIPTION
       The client requires the PRIV_WIN_DAC_READ and PRIV_WIN_MAC_READ privileges. The XTSOLgetPropUID() function retrieves  the  ownership  of  a
       window's property. This allows a client to get the ownership of an object it did not create.

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), XTSOLsetPropUID(3XTSOL), attributes(5)

       Setting Window Polyinstantiation Information in Solaris Trusted Extensions Developer's Guide

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 					   XTSOLgetPropUID(3XTSOL)