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

NAME

       XTSOLsetSSHeight - set the height of screen stripe

SYNOPSIS

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

       Status XTSOLsetSSHeight(display, screen_num, newheight);

       Display *display;
       int screen_num;
       int newheight;

PARAMETERS

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

       screen_num    Specifies the screen number.

       newheight     Specifies the height of the stripe in pixels.

DESCRIPTION

       The  XTSOLsetSSHeight()	function  sets the height of the trusted screen stripe at the bottom of the screen. Currently the screen stripe is
       present only on the default screen. The client must have the Trusted Path process attribute.

RETURN VALUES

       None.

ERRORS

       BadAccess    Lack of privilege.

       BadValue     Not a valid screen_num or newheight.

ATTRIBUTES

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

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

SEE ALSO

       libXtsol(3LIB), XTSOLgetSSHeight(3XTSOL), attributes(5)

       Accessing and Setting the Screen Stripe Height 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 					  XTSOLsetSSHeight(3XTSOL)