opensolaris man page for xtsolgetresattributes

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

NAME
       XTSOLgetResAttributes - get all label attributes associated with a window or a pixmap

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

       Status XTSOLgetResAttributes(display, object, type, winattrp);

       Display *display;
       XID object;
       ResourceType type;
       XTSOLResAttributes *winattrp;

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

       object	   Specifies the ID of a window system object. Possible window system objects are windows and pixmaps.

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

       winattrp    Client must provide a pointer to XTSOLResAttributes.

DESCRIPTION
       The  client  requires  the  PRIV_WIN_DAC_READ  and  PRIV_WIN_MAC_READ  privileges. The XTSOLgetResAttributes() function retrieves all label
       attributes that are associated with a window or a pixmap in a single call. The attributes include UID, sensitivity label,  and  workstation
       owner.

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:

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

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

       Obtaining Window Attributes 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 				     XTSOLgetResAttributes(3XTSOL)