NT_Shutdown

	This functionality is not available under Windows CE!

The Windows NT operating system can be shut down with the aid of the function block NT_Shutdown. The function largely corresponds to the Shut Down command on the Windows taskbar. A delay before execution of the Shut Down command can be defined via the DELAY parameter.

Notes:

Newer operating systems ( e.g. Windows 2000 ) perform with the aid of the "NT_Shutdown" function block the "Shutdown with Power OFF" ( the computer switches its power OFF). This function can only be used on systems which are ACPI conform (Advanced Configuration and Power Interface). The ACPI functions should be activated in BIOS before the installation of the operating system.

The ACPI-functions have to be supported by the motherboard and the power supply of the PC. A change afterwards is not recognized by the operating system. If there is an ACPI-supporting PC, you can check e. g. at Windows 2000 in the following way:

1. In the "System Manager" open the folder "system".

2. on the tab "Hardware" choose the "Device Manager".

In the navigation tree with the devices now you can read at "Computer": "Advanced Configuration and Power Interface (ACPI) PC".

NT_Shutdown 3:

The default TwinCAT settings are to perform shutdown with power OFF. You can disable the power OFF function in windows registry. Please add following entry:

"DisableACPIPowerOff"REG_DWORD = 0x00000001 in Registry under: "HKEY_LOCAL_MACHINE\SOFTWARE\Beckhoff\TwinCAT\System"

Inputs

VAR_INPUT
    NETID  : T_AmsNetId;
    DELAY  : DWORD;
    START  : BOOL;
    TMOUT  : TIME := DEFAULT_ADS_TIMEOUT;
END_VAR

Name	Type	Description
NETID	T_AmsNetID	The network address of the TwinCAT computer whose local Windows system time is to be set can be specified here. For the local computer an empty string may be specified.
DELAY	DWORD	The delay time, in seconds, before the Shut Down command is executed.
START	BOOL	The function block is enabled by a positive edge at this input.
TMOUT	TIME	Time-out period that may not be exceeded when executing the ADS command.

Outputs

VAR_OUTPUT
    BUSY         : BOOL;
    ERR          : BOOL;
    ERRID        : UDINT;
END_VAR

Name	Type	Description
BUSY	BOOL	When the function block is enabled, this output is set and remains set until a feedback is received.
ERR	BOOL	If an error should occur during the transfer of the command, then this output is set once the BUSY output was reset.
ERRID	ADS error number	Returns the error code, if the ERR output is set.

Requirements

Development environment	Target platform	PLC libraries to be integrated (category group)
TwinCAT v3.1.0	PC or CX (WES7/Win7/Win10: TC RT x86/x64, WEC6/7: TC RT x86, WEC7: TC CE7 ARMV7)	Tc2_Utilities (System)