Windows Dev Center

IRegistrationInfo::SecurityDescriptor property

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(
  [in]  VARIANT sddl
);

HRESULT get_SecurityDescriptor(
  [out] VARIANT *pSddl
);

Property value

The security descriptor that is associated with the task.

Error codes

NameMeaning
S_OK

The property value was successfully set or retrieved.

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

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

Taskschd.h

Library

Taskschd.lib

DLL

Taskschd.dll

See also

IRegistrationInfo
Task Scheduler

 

 

Community Additions

ADD
Show:
© 2015 Microsoft