1XTSOLsetResLabelT(r3uXsTtSeOdL)Extensions to X Windows LibraryXFTuSnOcLtsieotnRsesLabel(3XTSOL)
2
3
4

NAME

6       XTSOLsetResLabel - set the label associated with a window or a pixmap
7

SYNOPSIS

9       cc [flag...] file... -lX11 -lXtsol [library...]
10       #include <X11/extensions/Xtsol.h>
11
12       Status XTSOLsetResLabel(display, object, type, sl);
13
14       Display *display;
15       XID object;
16       ResourceType type;
17       m_label_t *sl;
18
19

PARAMETERS

21       display    Specifies  a pointer to the Display structure; returned from
22                  XOpenDisplay().
23
24
25       object     Specifies the ID of a window system object whose  label  you
26                  want  to  change. Possible window system objects are windows
27                  and pixmaps.
28
29
30       type       Specifies what type of resource is being accessed.  Possible
31                  values are IsWindow and IsPixmap.
32
33
34       sl         Specifies a pointer to a sensitivity label.
35
36

DESCRIPTION

38       The   client  must  have  the  PRIV_WIN_DAC_WRITE,  PRIV_WIN_MAC_WRITE,
39       PRIV_WIN_UPGRADE_SL, and PRIV_WIN_DOWNGRADE_SL privileges. The XTSOLse‐
40       tResLabel() function changes the label that is associated with a window
41       or a pixmap.
42

RETURN VALUES

44       None.
45

ERRORS

47       BadAccess    Lack of privilege.
48
49
50       BadPixmap    Not a valid pixmap.
51
52
53       BadValue     Not a valid type or sl.
54
55

ATTRIBUTES

57       See attributes(5) for descriptions of the following attributes:
58
59
60
61
62       ┌───────────────────────────┬───────────────────────────────┐
63       │      ATTRIBUTE TYPE       │        ATTRIBUTE VALUE        │
64       ├───────────────────────────┼───────────────────────────────┤
65       │Interface Stability        │ Committed                     │
66       ├───────────────────────────┼───────────────────────────────┤
67       │MT-Level                   │ Unsafe                        │
68       └───────────────────────────┴───────────────────────────────┘
69

SEE ALSO

71       libXtsol(3LIB),      XTSOLgetResAttributes(3XTSOL),      XTSOLgetResLa‐
72       bel(3XTSOL), attributes(5)
73
74
75       Setting a Window Label in Solaris Trusted Extensions Developer's Guide
76

NOTES

78       The  functionality  described  on this manual page is available only if
79       the system is configured with Trusted Extensions.
80
81
82
83SunOS 5.11                        20 Jul 2007         XTSOLsetResLabel(3XTSOL)
Impressum