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

See also

IRegistrationInfo

Task Scheduler