opensolaris man page for xtsolsetreslabel

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

NAME
       XTSOLsetResLabel - set the label associated with a window or a pixmap

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

       Status XTSOLsetResLabel(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 change. Possible window system objects are windows and
		  pixmaps.

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

       sl	  Specifies a pointer to a sensitivity label.

DESCRIPTION
       The client must have the PRIV_WIN_DAC_WRITE, PRIV_WIN_MAC_WRITE, PRIV_WIN_UPGRADE_SL, and PRIV_WIN_DOWNGRADE_SL	privileges.  The  XTSOLse-
       tResLabel() function changes the label that is associated with a window or a pixmap.

RETURN VALUES
       None.

ERRORS
       BadAccess    Lack of privilege.

       BadPixmap    Not a valid pixmap.

       BadValue     Not a valid type or sl.

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

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

SEE ALSO
       libXtsol(3LIB), XTSOLgetResAttributes(3XTSOL), XTSOLgetResLabel(3XTSOL), attributes(5)

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