Building and Testing a GINA DLL

All functions, prototypes, structures, and constants are defined in the Winwlx.h header file.

Note

GINA DLLs are ignored in Windows Vista.

 

To test a GINA DLL, use the Winlogon.exe from a checked version of the operating system, which is available with the Microsoft Windows Driver Development Kit (DDK). The checked version of Winlogon supports debugging GINAs as follows:

  • You can use the following syntax to create a section in Win.ini to specify Winlogon debugging options.

    [WinlogonDebug]
    LogFile=C:\Winlogon.log
    DebugFlags=Flag1 [, Flag2 ...]
    

    If specified, LogFile should contain the fully qualified name of the file that will be used to log debugging information. If the file does not exist, it will be created.

    The DebugFlags options specify which kinds of debugging information to write to the log file, or debugger. DebugFlags can contain one or more of the following flags.

    Debugging flag Description
    CoolSwitch The CTRL+ALT+SHIFT+TAB key combination will cause a debug break in Winlogon.
    Error Print errors.
    Init Print initialization and progress messages.
    Notify Print notification package messages.
    SAS Print information about secure attention sequence (SAS) notifications.
    State Print messages when Winlogon changes state.
    Timeout Print messages when a time limit is set or a time limit is reached.
    Trace Print verbose trace information.
    Warn Print warnings.

     

  • To start the checked version of Winlogon in a debugger, add the following entry to the registry:

    HKEY_LOCAL_MACHINE
       Software
          Microsoft
             Windows NT
                CurrentVersion
                   Image File Execution Options
                      winlogon.exe
                         Debugger = ntsd -d<dl>
    <dt>
    
    

                     Data type

                     REG_SZ
```
> [!Note]  
> You must use the Windows symbolic debugger (NTSD) to debug Winlogon.

 

Loading and Running a GINA DLL

GINA Export Functions

GINA Structures

Terminal Services GINA Functions