Calin's Humble Scanner - User Guide

## Scan method Shutdown/Reboot

Using Windows API, this method can shutdown or reboot a remote host if provided credentials have necesary rights.

In automatic mode, this method uses the credentials of logged on user.
If NOT in automatic mode, you have to provide the credentials of a user with appropiate rights for remote hosts. Be avare that in this case, the authentification is done in CLEAR text!

The message provided will be displayed on the remote hosts. Also, Windows XP will log the event 1704 in System log. That message will have the "Comment" field set to the provided message.
Due to Windows XP SP1 and Windows Server 2003 requirements the comment message is limited to 3072 characters, that is why `CHScanner` will truncate the message if it is longer.

The time-out interval is limited to 10 years due to the requirements of Windows XP SP1 and Windows Server 2003. Well, I do not think that you need a bigger value...
If the time-out interval is zero no message will be displayed.

## Parameters

In NO parameters are specified this method will perform a forced shutdown with a time-out value of 30 seconds and no message.
Parameters can be specified as follow (any leading or trailing white spaces will be removed before processing): `[Shutdown + Forced [+ TimeOut] [+ SP + Message]]`, where:

- `Shutdown` if 'T', sends a shutdown command. if 'F', will send a reboot command. Any other character will throw an error when executed;
- `Forced` if 'T', will force the command, if 'F', not. Any other character will throw an error when executed;
- `TimeOut` the time-out value, in seconds, the dialog box should be displayed;
- `Message` the message to be displayed in the dialog box.

## Examples

Here are some examples for parameter specification:

- `TT` means forced shutdown, no timeout and no message;
- `FF` means normal restart, no timeout and no message;
- `FT20 Administrative shutdown!` means forced restart, 20 seconds time-out and the message "Administrative shutdown!" displayed;

[ User Guide | Scan Methods ]

Copyright © 2006 - 2009 Calin Radoni Hosted on http://www.geocities.com/calinradoni Last page modification is 29 January 2007