XTSOLgetResLabel

- get the label associated with a window, a pixmap, or a colormap

Synopsis

#include <X11/extensions/Xtsol.h>

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

Display *display;
XID object;
ResourceType type;
m_label_t *sl;

Description

The client requires the PRIV_WIN_DAC_READ and PRIV_WIN_MAC_READ privileges. XTSOLgetResLabel() is used to get the label that is 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 label you want to get. Possible window system objects are windows, pixmaps, and colormaps.

type

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

sl

Returns a sensitivity label which is the current label of the specified object.

Attributes

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

Return Values

None

Errors

BadAccess

Lack of privilege

BadPixmap

Not a valid pixmap

BadValue

Not a valid type

See Also

XTSOLgetClientAttributes(3XTSOL), XTSOLsetResLabel(3XTSOL)

Obtaining a Window Label in Solaris Trusted Extensions Developer’s Guide