XSetWMProtocols(3X11) AIX (XLIB FUNCTIONS) XSetWMProtocols(3X11) 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 pro- perty on the specified window with the list of atoms speci- fied by the protocols argument. 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 pro- perty on the specified window to the list of atoms specified 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 participate. If the pro- perty 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 argument to the number of elements in the list, and returns a nonzero status. Otherwise, it sets neither of Rev. Release 5 Page 1 XSetWMProtocols(3X11) AIX (XLIB FUNCTIONS) XSetWMProtocols(3X11) 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 Rev. Release 5 Page 2