IPrincipal2 interface (taskschd.h)
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 |