XTSOLgetResLabel(3)

NAME | SYNOPSIS | DESCRIPTION | PARAMETERS | ATTRIBUTES | RETURN VALUES | ERRORS | SEE ALSO

NAME

XTSOLgetResLabel- Get the CMW label associated with a window, a pixmap, or a colormap

SYNOPSIS

#include <tsol/Xtsol.h>

Display *display;
XID object;
ResourceType type;
bclabel_t *cmwlabel;

Status XTSOLgetResLabel(display, object, type, cmwlabel);

DESCRIPTION

The client requires the PRIV_WIN_DAC_READ and PRIV_WIN_MAC_READ privileges. XTSOLgetResLabel() is used to get the CMW label associated with a window or a pixmap or a colormap.

PARAMETERS

display

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

object

Specifies the ID of a window system object whose CMW label you want to get. Possible window system objects are windows, and pixmaps or colormaps.

type

Specifies what type of resource is being accessed. Possible values are IsWindow, IsPixmap or IsColormap.

cmwlabel

Returns a CMW label which is the current CMW label of the specified object. This label contains an SL. Client needs to provide a bclabel_t type storage and passes the address of this storage as the function argument. Client must provide a pointer to bclabel_t.

ATTRIBUTES

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

ATTRIBUTE TYPE	ATTRIBUTE VALUE
Availability	SUNWxwplt (available only on Trusted Solaris systems)
MT-Level	MT-Unsafe

RETURN VALUES

None

ERRORS

BadAccess

Lack of privilege

BadPixmap

Not a valid pixmap

BadValue

Not a valid type

SEE ALSO

XTSOLgetClientAttributes(3), XTSOLsetResLabel(3)

SunOS 5.8  Last Revised 30 Sep 1999

NAME | SYNOPSIS | DESCRIPTION | PARAMETERS | ATTRIBUTES | RETURN VALUES | ERRORS | SEE ALSO