Поделиться через


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

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