opensolaris man page for xtsolsetpolyinstinfo

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

NAME
       XTSOLsetPolyInstInfo - set polyinstantiation information

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

       Status XTSOLsetPolyInstInfo(display, sl, uidp, enabled);

       Display *display;
       m_label_t sl;
       uid_t *uidp;
       int enabled;

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

       sl	  Specifies the sensitivity label.

       uidp	  Specifies the pointer to UID.

       enabled	  Specifies whether client can set the property information retrieved.

DESCRIPTION
       The  XTSOLsetPolyInstInfo()  function  sets  the polyinstantiated information to get property resources. By default, when a client requests
       property data for a polyinstantiated property, the data returned corresponds to the SL and UID of the requesting client. To get	the  prop-
       erty  data associated with a property with specific sl and uid, a client can use this call to set the SL and UID with enabled flag to TRUE.
       The client should also restore the enabled flag to FALSE after retrieving the property value. Client must have the  PRIV_WIN_MAC_WRITE  and
       PRIV_WIN_DAC_WRITE privileges.

RETURN VALUES
       None.

ERRORS
       BadAccess    Lack of privilege.

       BadValue     Not a valid display 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), 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 				      XTSOLsetPolyInstInfo(3XTSOL)