IRegistrationInfo::put_SecurityDescriptor method (taskschd.h)

Gets or sets the security descriptor of the task. If a different security descriptor is supplied during task registration, it will supersede the security descriptor that is set with this property.

This property is read/write.

Syntax

HRESULT put_SecurityDescriptor(
  VARIANT sddl
);

Parameters

sddl

Return value

None

Remarks

When reading or writing XML for a task, the security descriptor of the task is specified using the SecurityDescriptor element of the Task Scheduler schema.

If a different security descriptor is supplied when a task is registered, then it will supersede the sddl parameter that is set through this property.

If you try to pass an invalid security descriptor into the sddl parameter, then this method will return E_INVALIDARG.

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

IRegistrationInfo

Task Scheduler