PE Builder v3 plugin

Shutdown Utilities

The Shutdown Utilities are written by Paraglider.


This plugin consists of these utilities:

In addition foreign language DLLs are included to allow the strings in the utilities to be replaced with localized strings. These dlls are named ShutdownRes_XX.dll and which ever one is selected must be copied to the PE CD as ShutdownRes.dll. Currently only ShutdownRes_DE.dll ( German ) is available. The source for the english version of the resource file is included so anybody can build a localized version.

The Shutdown utility can take one or more of the following command line parameters:

/EjectBootDrive or /B

Before shutting down or rebooting eject the boot CD. Use the /CloseBootDrive option if your bios does not automatically close the boot CD on reboot.

/C[loseBootDrive]

Close the boot drive. Some computer bioses do this automatically on a reboot. Others do not. This is for the ones that do not or if you wish to close the drawer on a shutdown.

/E[ject]

Before shutting down or rebooting eject any CDs. Any none boot CDs will be ejected sequentially and closed prior to ejecting the boot CD. Use the /CloseBootDrive option if your bios does not automatically close the boot CD on reboot.

/G[ui]

Show the closedown gui from the msgina dll. By default ginaorg.dll is used assuming you are using the replacement msgina from these utilities. If you are not then use the /m parameter to specify the original dll name.

/H[ide]

Minimize the auto timer dialog when it starts.

/I[nitiate]

Show the initiate timer dialog which allows the timeout value ( either an absolute  number of  hours / minutes / seconds or a specific time ) to be selected and the action to perform on timer expiry. The timer will start when the enable timer button is selected. Before the timer expires the timer can be cancelled by selecting the cancel timer button.

/I[nitiate] <Timeout>

Will initiate a closedown / restart after the specified timeout value. Whilst this timer is counting down a dialog will be shown with the time to close down being updated every second. If the cancel button is hit on this dialog prior to the time to close down time becoming zero then the close down will be cancelled.

The <Timeout> value can either be a number of seconds or an absolute time in the format hh:mm[:ss] . The :ss part of the absolute time is optional. The absolute time is specified in 24hr format thus 5PM is 17:00 . On display of the dialog if the absolute time is earlier than the current time then it will be assumed to represent a time tomorrow e.g. you can wait at most 24hrs.

The action taken when the timeout expires is selected with the other parameters e.g. restart in 60 seconds is "shutdown /i 60 /r".

There must be at least one space between the /I[nitiate] and the <Timeout>.

/M[sgina]  <DLLName>

Name of original msgina.dll used for showing the gui. If the original has been renamed to something other than ginaorg.dll or it has not been renamed and you are using the /g option then you must use this option to name the dll. There must be at least one space between /M[sgina] and <DLLName>. Thus if the msgina has not been renamed you must use "/M msgina.dll". If it had been renamed to pegina.dll you would specify "/m pegina.dll".

/P[owerdown]

Powerdown the computer. This should not be used with /Shutdown.

/R[eboot]T[imeout] <TimeoutValue>

Species the delay in milliseconds before rebooting after completing any other closedown actions like opening and closing media drawers. There must be at least one space between /R[eboot]T[imeout] and <TimeoutValue> .i.e. /RT  5000 or /RebootTimeout  5000. If the drawer is closed then this will be the delay after closing the drawer and before rebooting.

/R[eboot]

Reboot the computer. This should not be used with /Shutdown.

/S[hutdown]

Shutdown the computer. This should not be used with /reboot.

/T[Timeout]  <TimeoutValue>

Specifies the delay in milliseconds between opening the CD drawer and closing it. If this is not specified then it defaults to 5000 ( 5 seconds ). There must be at least one space between /T[imeout] and <TimeoutValue>.

/Tr[ay]

When the dialog is minimized then minimize to the taskbar tray instead of the taskbar.

/U
Use this option if your system fails to shutdown after ejecting the boot drive when using the shutdown.exe program and you are using an explorer plugin. This option requests that explorer is used to perform the eject / shutdown.


PE Builder Copyright (c) 2002-2003 Bart Lagerweij. All rights reserved.