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)