NAME
        SetAmigaGuideContextA - Set the context ID for an AmigaGuide system.
                                                               (V34)
   SYNOPSIS
        success = SetAmigaGuideContextA ( handle, context, attrs );
        d0                                 a0       d0      d1

        bool setamigaguidecontexta (amigaguidecontext, ulong,
                                    struct tagitem *);

        success = SetAmigaGuideContext (handle, context, tag1, ...);

        bool setamigaguidecontext (amigaguidecontext, ulong, tag, ...);

   FUNCTION
        This function, and the SendAmigaGuideContext() function, are used to
        provide a simple way to display a node based on a numeric value,
        instead of having to build up a slightly more complex command
        string.

   INPUTS
        handle -- Handle to an AmigaGuide system.

        context -- Index value of the desired node to display.

        future -- Future expansion, must be set to NULL for now.

   EXAMPLE

        /* sample context table */
        strptr contextarray[] =
        {
            "MAIN",
            "FILEREQ",
            "PRINT",
            "ABOUT",
            NULL
        };

        /* quickie defines */
        #define HELP_MAIN      0
        #define HELP_FILEREQ   1
        #define HELP_PRINT     2
        #define HELP_ABOUT     3

        ...

        struct newamigaguide nag = {null};

        /* initialize the context table */
        nag.nag_Context = ContextArray;

        ...

        /* bring up help on a particular subject */
        SetAmigaGuideContext(handle, HELP_ABOUT, NULL);

   RETURNS
        success - Returns TRUE if a valid context ID was passed,
            otherwise returns FALSE.

   SEE ALSO
        sendamigaguidecontexta(), sendamigaguidecmda()