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 取得或設定主體的名稱。 (Put)
IPrincipal：:p ut_GroupId 取得或設定執行與主體相關聯之工作所需的使用者群組標識碼。 (Put)
IPrincipal：:p ut_Id 取得或設定主體的識別碼。 (Put)
IPrincipal：:p ut_LogonType 取得或設定執行與主體相關聯之工作所需的安全性登入方法。 (Put)
IPrincipal：:p ut_RunLevel 取得或設定標識碼，用來指定執行與主體相關聯之工作所需的許可權等級。 (Put)
IPrincipal：:p ut_UserId 取得或設定執行與主體相關聯之工作所需的使用者標識碼。 (Put)

指定帳戶時，請記得在程式碼中正確使用雙反斜杠來指定網域和用戶名稱。例如，使用 DOMAIN\UserName 指定 UserId 屬性的值。

讀取或寫入工作的 XML 時，主體的安全性認證是在工作排程器架構的 Principal 元素中指定。

如果使用 at.exe 命令行工具來註冊工作，而且此介面用來擷取工作的相關信息，則LogonType 屬性會傳回0、 RunLevel 屬性會傳回 0，而 UserId 屬性會傳回 NULL。

如需此介面的詳細資訊和範例程式代碼，請參閱時間觸發程式範例 (C++) 或註冊觸發程式範例 (C++) 。