Интерфейс 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++).

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	taskschd.h

См. также раздел

ITaskDefinition

Основное свойство ITaskDefinition

Интерфейсы планировщика задач