opensolaris man page for xtsolgetreslabel

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

NAME
       XTSOLgetResLabel - get the label associated with a window, a pixmap, or a colormap

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

       Status XTSOLgetResLabel(display, object, type, sl);

       Display *display;
       XID object;
       ResourceType type;
       m_label_t *sl;

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

       object	  Specifies the ID of a window system object whose label you want to get. Possible window system objects are windows, pixmaps, and
		  colormaps.

       type	  Specifies what type of resource is being accessed. Possible values are IsWindow, IsPixmap or IsColormap.

       sl	  Returns a sensitivity label which is the current label of the specified object.

DESCRIPTION
       The client requires the PRIV_WIN_DAC_READ and PRIV_WIN_MAC_READ privileges. The XTSOLgetResLabel() function retrieves  the  label  that	is
       associated with a window or a pixmap or a colormap.

RETURN VALUES
       None.

ERRORS
       BadAccess    Lack of privilege.

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

       Obtaining a Window Label 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 					  XTSOLgetResLabel(3XTSOL)