IPrincipal2 interface (taskschd.h)

Article
07/27/2022

Provides the extended settings applied to security credentials for a principal. These security credentials define the security context for the tasks that are associated with the principal.

Inheritance

The IPrincipal2 interface inherits from the IDispatch interface. IPrincipal2 also has these types of members:

Methods

The IPrincipal2 interface has these methods.


IPrincipal2::AddRequiredPrivilege Adds the required privilege to the task process token.
IPrincipal2::get_ProcessTokenSidType Gets or sets the task process security identifier (SID) type. (Get)
IPrincipal2::get_RequiredPrivilege Gets the required privilege of the task by index.
IPrincipal2::get_RequiredPrivilegeCount Gets the number of privileges in the required privileges array.
IPrincipal2::put_ProcessTokenSidType Gets or sets the task process security identifier (SID) type. (Put)

Remarks

When reading or writing XML for a task, the security credentials for a principal are specified in the Principal element of the Task Scheduler schema.

Examples

For more information and example code for this interface, see Time Trigger Example (C++) or Registration Trigger Example (C++).

Requirements

Requirement	Value
Minimum supported client	Windows 7 [desktop apps only]
Minimum supported server	Windows Server 2008 R2 [desktop apps only]
Target Platform	Windows
Header	taskschd.h