Lock Workstation Action

Declaration

<AMLOCKWORKSTATION>

See Also

Lock Workstation Action-Setting Properties, Log Off Action, Restart Action, Shut Down Action, Suspend/Hibernate Action

Description

Submits a request to lock the workstation's display. Locking a workstation protects it from unauthorized use.  Available on Windows NT/2000/XP.

Practical Usage

Used to lock the workstation. It is common to use this action to lock the workstation only if the task was started when it was locked (see example).

Parameters

None.

Notes

Custom Description

This action includes the Description tab for entering a custom step description.

More on setting custom step description

Standard Error Handling Options

This action also includes the standard Error Causes and On Error failure handling options/tabs.

More on Error Handling Options

Variables and Expressions

All text fields allow the use of expressions, which can be entered by surrounding the expression in percentage signs (example: %MYVARIABLE%, %Left('Text',2)%). To help construct these expressions, you can open Expression Builder from these fields by pressing F2.

More on variables
More on expressions

More on the expression builder

Example

NOTE: The code below can be copied and pasted directly into the Steps pane of the Task Builder.

<AMVARIABLE NAME="AMTrigger.WasLocked" ISPARAMETER="YES">1</AMVARIABLE>
<!--- Place these steps at the end of the task to make it re-lock if the task was started locked --->
<AMIF EXPRESSION="%AMTrigger.WasLocked% = 1">
<AMLOCKWORKSTATION>
</AMIF>