NAME

       XkbGetKeySyms - Obtain the symbols for a subset of the keys in a keyboard description

SYNOPSIS

       Status XkbGetKeySyms (Display *dpy, unsigned int first, unsigned int num, XkbDescPtr xkb);

ARGUMENTS

       - dpy  connection to X server

       - first
              keycode of first key to get

       - num  number of keycodes for which syms desired

       - xkb  Xkb description to be updated

DESCRIPTION

       XkbGetKeySyms  sends a request to the server to obtain the set of keysyms bound to num keys starting with
       the key whose keycode is first.  It waits for a reply and returns the keysyms in the  map.syms  field  of
       xkb.   If  successful,  XkbGetKeySyms returns Success. The xkb parameter must be a pointer to a valid Xkb
       keyboard description.

       If the client map in the xkb parameter has not been allocated, XkbGetKeySyms allocates and initializes it
       before obtaining the symbols.

       If  a compatible version of Xkb is not available in the server or the Xkb extension has not been properly
       initialized, XkbGetKeySyms returns BadAccess. If num is less  than  1  or  greater  than  XkbMaxKeyCount,
       XkbGetKeySyms returns BadValue. If any allocation errors occur, XkbGetKeySyms returns BadAlloc.

RETURN VALUES

       Success        The  XkbGetKeySyms  function returns Success if it gets a reply to a request to the server
                      to obtain the set of keysyms bound to num keys starting with  the  key  whose  keycode  is
                      first.

DIAGNOSTICS

       BadAccess      The Xkb extension has not been properly initialized

       BadAlloc       Unable to allocate storage

       BadValue       An argument is out of range