IPrincipal 接口 (taskschd.h)

为主体提供安全凭据。 这些安全凭据定义与主体关联的任务的安全上下文。

继承

IPrincipal 接口继承自 IDispatch 接口。

方法

IPrincipal 接口具有这些方法。

 
IPrincipal::get_DisplayName

获取或设置主体的名称。 (获取)
IPrincipal::get_GroupId

获取或设置运行与主体关联的任务所需的用户组的标识符。 (获取)
IPrincipal::get_Id

获取或设置主体的标识符。 (获取)
IPrincipal::get_LogonType

获取或设置运行与主体关联的任务所需的安全登录方法。 (获取)
IPrincipal::get_RunLevel

获取或设置标识符,该标识符用于指定运行与主体关联的任务所需的特权级别。 (获取)
IPrincipal::get_UserId

获取或设置运行与主体关联的任务所需的用户标识符。 (获取)
IPrincipal::p ut_DisplayName

获取或设置主体的名称。 (放置)
IPrincipal::p ut_GroupId

获取或设置运行与主体关联的任务所需的用户组的标识符。 (放置)
IPrincipal::p ut_Id

获取或设置主体的标识符。 (放置)
IPrincipal::p ut_LogonType

获取或设置运行与主体关联的任务所需的安全登录方法。 (放置)
IPrincipal::p ut_RunLevel

获取或设置标识符,该标识符用于指定运行与主体关联的任务所需的特权级别。 (放置)
IPrincipal::p ut_UserId

获取或设置运行与主体关联的任务所需的用户标识符。 (放置)

注解

指定帐户时,请记得在代码中正确使用双反斜杠来指定域和用户名。 例如,使用 DOMAIN\UserName 为 UserId 属性指定值。

读取或写入任务的 XML 时,将在任务计划程序架构的 Principal 元素中指定主体的安全凭据。

如果使用 at.exe 命令行工具注册任务,并且此接口用于检索有关该任务的信息,则 LogonType 属性将返回 0,RunLevel 属性将返回 0,UserId 属性将返回 NULL

示例

有关此接口的详细信息和示例代码,请参阅 时间触发器示例 (C++) 注册触发器示例 (C++)

要求

要求
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 taskschd.h

另请参阅

ITaskDefinition

ITaskDefinition 的 Principal 属性

任务计划程序接口