hpux man page for xfetchname

XFetchName()															      XFetchName()

Name
  XFetchName - get a window's name (XA_WM_NAME property).

Synopsis
  Status XFetchName(display, w, window_name_return)
	Display *display;
	Window w;
	char **window_name_return;

Arguments
  display   Specifies a connection to an X server; returned from XOpenDisplay().

  w	    Specifies the ID of the window whose name you want a pointer set to.

  window_name_return
	    Returns  a	pointer  to the window name, which will be a NULL-terminated string.  If the XA_WM_NAME property has not been set for
	    this window, XFetchName() sets window_name_return to NULL.	When finished with it, a client  must  free  the  name	string	using
	    XFree().

Returns
  Zero on failure, non-zero on success.

Description
  XFetchName()	is superseded by XGetWMName() in Release 4.  XFetchName() returns the current value of the XA_WM_NAME property for the speci-
  fied window.	XFetchName() returns non-zero if it succeeds, and zero if the property has not been set for the argument window.

  If the data returned by the server is in the Latin Portable Character Encoding, then the returned string is in the Host Portable  Character
  Encoding.  Otherwise, the result is implementation-dependent.

  For more information, see Volume One, Chapter 12, Interclient Communication, and Chapter 16, Window Management.

Errors
  BadWindow

See Also
  XGetClassHint(),   XGetIconName(),   XGetIconSizes(),  XGetNormalHints(),  XGetSizeHints(),  XGetTransientForHint(),	XGetWMHints(),	XGet-
  ZoomHints(), XSetClassHint(), XSetCommand(), XSetIconName(), XSetIconSizes(), XSetNormalHints(),  XSetSizeHints(),  XSetTransientForHint(),
  XSetWMHints(), XSetZoomHints(), XStoreName().

Xlib - Window Manager Hints													      XFetchName()