XTSOLsetResLabel

- set the label associated with a window or a pixmap

Synopsis

#include <X11/extensions/Xtsol.h>

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

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

Description

The client must have the PRIV_WIN_DAC_WRITE, PRIV_WIN_MAC_WRITE, PRIV_WIN_UPGRADE_SL, and PRIV_WIN_DOWNGRADE_SL privileges.

XTSOLsetResLabel() is used to change the label that is associated with a window or a pixmap.

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 change. Possible window system objects are windows and pixmaps.

type

Specifies what type of resource is being accessed. Possible values are IsWindow and IsPixmap.

sl

Specifies a pointer to a sensitivity label.

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 or sl

See Also

XTSOLgetResAttributes(3XTSOL), XTSOLgetResLabel(3XTSOL)

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