IRegistrationInfo::get_SecurityDescriptor method (taskschd.h)

Article
02/22/2024

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 get_SecurityDescriptor(
  VARIANT *pSddl
);

Parameters

pSddl

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