[Contents] [Index] [Help] [Retrace] [Browse <] [Browse >]


    NAME 
        OpenWorkBench -- open the workbench screen.

    SYNOPSIS 
        WBScreen = OpenWorkBench()
        D0

        ULONG OpenWorkBench( VOID );

    FUNCTION 
        This routine attempts to reopen the Workbench.  The actions taken are:
            - general good stuff and nice things, and then return a non-null
              pointer to the Workbench screen.
            - find that something has gone wrong, and return NULL

        The return value, if not NULL, is indeed the address of the Workbench
        screen, although you should not use it as such.  This is because the
        Workbench may be closed by other programs, which can invalidate
        the address at any time.  We suggest that you regard the return
        value as a ULONG indication that the routine has succeeded, if
        you pay any attention to it at all.

    INPUTS 
        None

    RESULT 
        non-zero if Workbench screen opened successfully, or was already
                opened
        zero if anything went wrong and the Workbench screen isn't out there

    BUGS 
        The name of this routine is spelled wrong: it ought to have been
        OpenWorkbench().

    SEE ALSO