1XTSOLgetResLabelT(r3uXsTtSeOdL)Extensions to X Windows LibraryXFTuSnOcLtgieotnRsesLabel(3XTSOL)
2
3
4

NAME

6       XTSOLgetResLabel - get the label associated with a window, a pixmap, or
7       a colormap
8

SYNOPSIS

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

PARAMETERS

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

DESCRIPTION

40       The  client requires the PRIV_WIN_DAC_READ and PRIV_WIN_MAC_READ privi‐
41       leges. The XTSOLgetResLabel() function  retrieves  the  label  that  is
42       associated with a window or a pixmap or a colormap.
43

RETURN VALUES

45       None.
46

ERRORS

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

ATTRIBUTES

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

SEE ALSO

72       libXtsol(3LIB),     XTSOLgetClientAttributes(3XTSOL),    XTSOLsetResLa‐
73       bel(3XTSOL), attributes(5)
74
75
76       Obtaining a Window Label  in  Solaris  Trusted  Extensions  Developer's
77       Guide
78

NOTES

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