[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