XGetCommand()XGetCommand()NameXGetCommand – get the XA_WM_COMMAND property (command-line arguments).
Synopsis
Status XGetCommand(display, w, argv_return, argc_return)
Display *display;
Window w;
char ***argv_return;
int *argc_return;
Arguments
display Specifies a connection to an X server; returned from
XOpenDisplay().
w Specifies the window.
argv_return
Returns the application's argument list.
argc_return
Returns the number of arguments returned.
Returns
Zero on failure, non-zero on success.
DescriptionXGetCommand() reads the XA_WM_COMMAND property from the specified win‐
dow and returns a string list. If the XA_WM_COMMAND property exists,
it is of type XA_STRING and format 8. If sufficient memory can be
allocated to contain the string list, XGetCommand() fills in the
argv_return and argc_return arguments and returns a non-zero status.
If the data returned by the server is in the Latin Portable Character
Encoding, then the returned strings are in the Host Portable Character
Encoding. Otherwise, the result is implementation-dependent. Other‐
wise, it returns a zero status. If the data returned by the server is
in the Latin Portable Character Encoding, then the returned strings are
in the Host Portable Character Encoding. Otherwise, the result is
implementation-dependent. To free the memory allocated to the string
list, use XFreeStringList().
Errors
BadWindow
See AlsoXFetchName(), XGetClassHint(), XGetIconName(), XGetIconSizes(), XGet‐
NormalHints(), XGetSizeHints(), XGetTransientForHint(), XGetWMHints(),
XGetZoomHints(), XSetClassHint(), XSetIconName(), XSetIconSizes(),
XSetNormalHints(), XSetSizeHints(), XSetTransientForHint(),
XSetWMHints(), XSetZoomHints(), XStoreName().
Xlib - Window Manager Hints XGetCommand()