


XSetWMProtocols(3X11)					XSetWMProtocols(3X11)
X11R5									X11R5



NAME
  XSetWMProtocols, XGetWMProtocols - set or read a window's WM__PROTOCOLS
  property

SYNTAX
  Status XSetWMProtocols(_d_i_s_p_l_a_y, _w, _p_r_o_t_o_c_o_l_s,	_c_o_u_n_t)
	Display	*_d_i_s_p_l_a_y;
	Window _w;
	Atom *_p_r_o_t_o_c_o_l_s;
	int _c_o_u_n_t;

  Status XGetWMProtocols(_d_i_s_p_l_a_y, _w, _p_r_o_t_o_c_o_l_s__r_e_t_u_r_n, _c_o_u_n_t__r_e_t_u_r_n)
	Display	*_d_i_s_p_l_a_y;
	Window _w;
	Atom **_p_r_o_t_o_c_o_l_s__r_e_t_u_r_n;
	int *_c_o_u_n_t__r_e_t_u_r_n;

ARGUMENTS

  _d_i_s_p_l_a_y   Specifies the connection to	the X server.

  _c_o_u_n_t	    Specifies the number of protocols in the list.

  _c_o_u_n_t__r_e_t_u_r_n
	    Returns the	number of protocols in the list.

  _p_r_o_t_o_c_o_l_s Specifies the list of protocols.

  _p_r_o_t_o_c_o_l_s__r_e_t_u_r_n
	    Returns the	list of	protocols.

DESCRIPTION
  The _X_S_e_t_W_M_P_r_o_t_o_c_o_l_s function replaces	the WM_PROTOCOLS property on the
  specified window with	the list of atoms specified by the protocols argu-
  ment.	 If the	property does not already exist, _X_S_e_t_W_M_P_r_o_t_o_c_o_l_s sets the
  WM_PROTOCOLS property	on the specified window	to the list of atoms speci-
  fied by the protocols	argument.  The property	is stored with a type of ATOM
  and a	format of 32.  If it cannot intern the WM_PROTOCOLS atom, _X_S_e_t_W_M_P_r_o_-
  _t_o_c_o_l_s returns a zero	status.	 Otherwise, it returns a nonzero status.

  _X_S_e_t_W_M_P_r_o_t_o_c_o_l_s can generate _B_a_d_A_l_l_o_c	and _B_a_d_W_i_n_d_o_w errors.

  The _X_G_e_t_W_M_P_r_o_t_o_c_o_l_s function returns the list	of atoms stored	in the
  WM_PROTOCOLS property	on the specified window.  These	atoms describe window
  manager protocols in which the owner of this window is willing to partici-
  pate.	 If the	property exists, is of type ATOM, is of	format 32, and the
  atom WM_PROTOCOLS can	be interned, _X_G_e_t_W_M_P_r_o_t_o_c_o_l_s sets the
  protocols_return argument to a list of atoms,	sets the count_return argu-
  ment to the number of	elements in the	list, and returns a nonzero status.
  Otherwise, it	sets neither of	the return arguments and returns a zero
  status.  To release the list of atoms, use _X_F_r_e_e.

  _X_G_e_t_W_M_P_r_o_t_o_c_o_l_s can generate a _B_a_d_W_i_n_d_o_w error.

PROPERTIES

  WM_PROTOCOLS
	    List of atoms that identify	the communications protocols between
	    the	client and window manager in which the client is willing to
	    participate.

DIAGNOSTICS

  _B_a_d_A_l_l_o_c  The	server failed to allocate the requested	resource or server
	    memory.

  _B_a_d_W_i_n_d_o_w A value for	a Window argument does not name	a defined Window.

SEE ALSO
  XAllocClassHint(3X11), XAllocIconSize(3X11), XAllocSizeHints(3X11),
  XAllocWMHints(3X11), XFree(3X11), XSetCommand(3X11),
  XSetTransientForHint(3X11), XSetTextProperty(3X11),
  XSetWMClientMachine(3X11), XSetWMColormapWindows(3X11),
  XSetWMIconName(3X11),	XSetWMName(3X11), XSetWMProperties(3X11),
  XStringListToTextProperty(3X11)
  _X_l_i_b - _C _L_a_n_g_u_a_g_e _X _I_n_t_e_r_f_a_c_e	delim off
















































