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 属性

任务计划程序接口