opensolaris man page for xtsolgetssheight

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

NAME
       XTSOLgetSSHeight - get the height of screen stripe

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

       Status XTSOLgetSSHeight(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 storage area where the height of the stripe in pixels is returned.

DESCRIPTION
       The  XTSOLgetSSHeight()	function gets the height of trusted screen stripe at the bottom of the screen. Currently the screen stripe is only
       present on the default screen. 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), XTSOLsetSSHeight(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 					  XTSOLgetSSHeight(3XTSOL)