ITaskFolder::SetSecurityDescriptor method (taskschd.h)

Article
02/22/2024

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