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++) 。