ITaskFolder::SetSecurityDescriptor method (taskschd.h)

Sets the security descriptor for the folder.

Syntax

HRESULT SetSecurityDescriptor(
  [in] BSTR sddl,
  [in] LONG flags
);

Parameters

[in] sddl

The security descriptor for the folder.

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

[in] flags

A value that specifies how the security descriptor is set.

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 folder in order to allow or deny certain users and groups access to a task folder.

Requirements

Requirement Value
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::SetSecurityDescriptor

ITaskFolder

ITaskFolder::GetSecurityDescriptor