IRegisteredTask::SetSecurityDescriptor method

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

Syntax

HRESULT SetSecurityDescriptor(
  BSTR sddl,
  LONG flags
);

Parameters

sddl

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

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

Return Value

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

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

   
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header taskschd.h
Library Taskschd.lib
DLL Taskschd.dll

See Also

IRegisteredTask

IRegisteredTask::SetSecurityDescriptor

ITaskFolder::GetSecurityDescriptor