opensolaris man page for xtsolsetssheight

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)