Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Sets the security descriptor that is used as credentials for the registered task.
Syntax
HRESULT SetSecurityDescriptor(
[in] BSTR sddl,
[in] LONG flags
);
Parameters
[in] 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.
[in] 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
| 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 |