Notice: This website is an unofficial Microsoft Knowledge Base (hereinafter KB) archive and is intended to provide a reliable access to deleted content from Microsoft KB. All KB articles are owned by Microsoft Corporation. Read full disclaimer for more details.

The Windows Vista Setup program runs a script file to enable custom deployment tasks


View products that this article applies to.

Introduction

This article describes a hook in the Windows Vista Setup program. The Setup program uses the hook to enable custom deployment tasks. The hook is in the form of a script file. The Setup program runs the script file as its final action.

Note The Graphical Identification and Authentication (GINA) component has been removed in Windows Vista.

↑ Back to the top


More information

The Setup program uses the following registry subkeys to execute the script file:
  • HKEY_LOCAL_MACHINE\SYSTEM\Setup\CmdLine

    This registry subkey specifies which process is called by the Setup program.
  • HKEY_LOCAL_MACHINE\SYSTEM\Setup\SetupType

    This registry subkey is used by the Winlogon.exe process to determine whether the system is in Setup mode. As soon as the Setup program runs the script file, the Setup program removes the value of this registry entry.

    If the Setup program updates the value of the HKEY_LOCAL_MACHINE\SYSTEM\Setup\CmdLine registry subkey, the Setup program must also update the value of the HKEY_LOCAL_MACHINE\SYSTEM\Setup\SetupType registry subkey.
  • HKEY_LOCAL_MACHINE\SYSTEM\Setup\SetupShutdownRequired

    The Setup program will not create this registry entry unless you have to restart or shut down the computer. If the computer must be restarted or shut down, the Setup program sets the value of the registry subkey to one of the following SHUTDOWN_ACTION values:
    • ShutdownPowerOff
    • ShutdownReboot
    • ShutdownNoReboot
If the Out Of Box Experience (OOBE) Wizard requires that the computer be restarted, the Setup program restarts the computer before the Setup program calls the script file.

The Setup program runs the script file only one time. The Setup program does not check the exit code or the error level of the script file before the Setup program is finished.

When the computer joins a Windows Domain during setup, Group Policy defined in the domain is not applied until the script is finished. This makes sure that the Group Policy configuration activity does not interfere with the setup script.

For more information about ways to extend the Vista setup, visit the following Microsoft Web site:

↑ Back to the top


Keywords: kbtshoot, kbexpertiseinter, kbinfo, KB939857

↑ Back to the top

Article Info
Article ID : 939857
Revision : 2
Created on : 2/20/2009
Published on : 2/20/2009
Exists online : False
Views : 897