XGetWMClientMachine()XGetWMClientMachine()NameXGetWMClientMachine – get a window's XA_WM_CLIENT_MACHINE property.
Synopsis
Status XGetWMClientMachine(display, w, text_prop_return)
Display *display;
Window w;
XTextProperty *text_prop_return;
Arguments
display Specifies a connection to an X server; returned from
XOpenDisplay().
w Specifies the window.
text_prop_return
Returns the XTextProperty structure that describes the
machine the client is running on.
Returns
Zero on failure, non-zero on success.
Availability
Release 4 and later.
DescriptionXGetWMClientMachine() performs an XGetTextProperty() to get the
WM_CLIENT_MACHINE property of the specified window. This property
should contain the name of the host machine on which this client is
being run, as seen from the server. This function returns non-zero
status in success; otherwise it returns a zero status.
This function is normally used along with XGetCommand() by a session
manager or window manager to get complete information on how to rein‐
voke an application.
For more information, see Volume One, Chapter 12, Interclient Communi‐
cation.
Structures
typedef struct {
unsigned char *value; /* same as Property routines */
Atom encoding; /* prop type */
int format; /* prop data format: 8, 16, or 32 */
unsigned long nitems; /* number of data items in value */
} XTextProperty;
See AlsoXSetWMClientMachine(), XGetCommand().
Xlib - Window Manager Hints XGetWMClientMachine()