Building and Testing a GINA DLL

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

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

Related topics

Loading and Running a GINA DLL

GINA Export Functions

GINA Structures

Terminal Services GINA Functions