Activator Plug-in > Functions reference > Actr_Shutdown
 |
Actr_Shutdown |
Shutdown the computer.
Syntax
Actr_Shutdown ( switches )
Parameters
| switches | determines the behavior of this command |
Switches
switches can be left empty or set to this:
| -Force | (currently Windows only) force other running applications to close |
Returned Result
Data type returned
Error code
Result
The returned result is an error code. If successful it returns 0. An error always starts with 2 dollars, followed by the error code. You should always check for errors. Returned error codes can be:
| 0 | no error | |
| $$-50 | paramErr | check if your parameters are correct |
Other errors may be returned.
Originated in
Activator Plug-in 3.6
Compatibility
FileMaker Pro 17 to 2023
Considerations
If you don’t specify the -Force switch the computer may not shutdown, because of other programs not closing.
There is a 20 second delay before the shutdown starts.
The -Force switch currently does not have any effect on macOS.
Example
Set Field [ result ; Actr_Shutdown ( "" ) ]This will shutdown the computer.
Set Field [ result ; Actr_Shutdown ( "-force" ) ]This will shutdown the computer, forcing all programs to close.
Used in example file
ShutdownRestart.fmp12
Related functions
| Actr_Restart |
| Actr_Sleep |
Related script step
| Shutdown Computer |
Related topics
Activator Plug-in online help (overview)
