Click above to get retro games delivered to your door ever month!

 BLIDBGHAN()
------------------------------------------------------------------------------
 Purpose:
 Get / set the Blinker debug handle.

 Syntax:
 nuHandle = BLIDBGHAN(nuHandle)

 Parameters:
 nuHandle  File handle for debugging output.

 Returns:
 Previous debug handle.

 Description:
 This function is used to set the Blinker overlay manager debug handle.
 It also returns the previous debug handle.

 This setting can be overridden at run time using the /DHn setting in the
 BLINKER environment variable.
 The new handle is not validated and may be either 1 to send output to the
 screen, 2 to send output to the standard error device, 4 to send output to
 the printer, or the DOS handle of a file opened by the program with a DOS
 open file call.
 This handle is used as the default output handle for a number of the other
 Blinker debugging functions, so may be set once at the start of the program
 rather than passing it as a parameter to each function individually.

 Example:
 #include <stdio.h>                                                          
 #include <blinker.h>                                                        
                                                                             
 void main(void)                                                             
 {                                                                           
 printf ("The debug handle was %i and is now the printer\n",                 
    BLIDBGHAN(4));                                                           
 }