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