RegisteredTask.SetSecurityDescriptor method

For scripting, sets the security descriptor that is used as credentials for the registered task.

Syntax

RegisteredTask.SetSecurityDescriptor( _
  ByVal sddl, _
  ByVal flags _
)

Parameters

sddl [in]

The security descriptor that is used as credentials for the registered task.

Note

If the Local System account is denied access to a task, then the Task Scheduler service can produce unexpected results.

flags [in]

Flags that specify how to set the security descriptor. The TASK_DONT_ADD_PRINCIPAL_ACE flag (0x10) from the TASK_CREATION enumeration can be specified.

Return value

This method does not return a value.

Remarks

You can specify the access control list (ACL) in the security descriptor for a task in order to allow or deny certain users and groups access to a task.

Requirements

Requirement Value
Minimum supported client
Windows Vista [desktop apps only]
Minimum supported server
Windows Server 2008 [desktop apps only]
Type library
Taskschd.tlb
DLL
Taskschd.dll

See also

RegisteredTask

TaskFolder.GetSecurityDescriptor

RegisteredTask.SetSecurityDescriptor