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

Synopsis:
    #include <wdefwin.h>
    int _dwSetConTitle( int handle, const char *title );

Description:
    The _dwSetConTitle function sets the console window's title which
    corresponds to the handle passed to it.  The argument handle is the
    handle associated with the opened console.  The argument title points to
    the string that will replace the current title.

    The _dwSetConTitle function is one of the support functions that can be
    called from an application using Watcom's default windowing support.

Returns:
    The _dwSetConTitle function returns 1 if it was successful and 0 if not.

Example:
    #include <wdefwin.h>
    #include <stdio.h>

    void main()
      {
        FILE *sec;

        _dwSetAboutDlg( "Hello World About Dialog",
                        "About Hello World\n"
                        "Copyright 1994 by WATCOM\n" );
        _dwSetAppTitle( "Hello World Application Title" );
        _dwSetConTitle( 0, "Hello World Console Title" );
        printf( "Hello World\n" );
        sec = fopen( "CON", "r+" );
        _dwSetConTitle( fileno( sec ),
                        "Hello World Second Console Title" );
        _dwDeleteOnClose( fileno( sec ) );
        fprintf( sec, "Hello to second console\n" );
        fprintf( sec, "Press Enter to close this console\n" );
        fflush( sec );
        fgetc( sec );
        fclose( sec );
      }

Classification:
    WATCOM

Systems:
    Windows, Win386, Win32, OS/2-32
See Also:
    _dwDeleteOnClose, _dwSetAboutDlg, _dwSetAppTitle, _dwShutDown, _dwYield