Microsoft KB Archive/939857

From BetaArchive Wiki
Knowledge Base


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

Article ID: 939857

Article Last Modified on 10/31/2007



APPLIES TO

  • Windows Vista Business
  • Windows Vista Enterprise
  • Windows Vista Home Premium
  • Windows Vista Home Basic
  • Windows Vista Ultimate
  • Windows Vista Business 64-bit Edition
  • Windows Vista Enterprise 64-bit Edition
  • Windows Vista Home Premium 64-bit Edition
  • Windows Vista Home Basic 64-bit Edition
  • Windows Vista Ultimate 64-bit Edition



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.

Notes

  • The Graphical Identification and Authentication (GINA) component has been removed in Windows Vista.
  • This article also applies to Windows Server Code Name "Longhorn."


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.

Keywords: kbinfo kbtshoot kbexpertiseinter KB939857