Interface IPrincipal (taskschd.h)

Fournit les informations d’identification de sécurité d’un principal. Ces informations d’identification de sécurité définissent le contexte de sécurité pour les tâches associées au principal.

Héritage

L’interface IPrincipal hérite de l’interface IDispatch.

Méthodes

L’interface IPrincipal a ces méthodes.

IPrincipal ::get_DisplayName Obtient ou définit le nom du principal. (Obtenir)
IPrincipal ::get_GroupId Obtient ou définit l’identificateur du groupe d’utilisateurs requis pour exécuter les tâches associées au principal. (Obtenir)
IPrincipal ::get_Id Obtient ou définit l'identificateur unique du principal. (Obtenir)
IPrincipal ::get_LogonType Obtient ou définit la méthode d’ouverture de session de sécurité requise pour exécuter les tâches associées au principal. (Obtenir)
IPrincipal ::get_RunLevel Obtient ou définit l’identificateur utilisé pour spécifier le niveau de privilège requis pour exécuter les tâches associées au principal. (Obtenir)
IPrincipal ::get_UserId Obtient ou définit l’identificateur d’utilisateur requis pour exécuter les tâches associées au principal. (Obtenir)
IPrincipal ::p ut_DisplayName Obtient ou définit le nom du principal. (Put)
IPrincipal ::p ut_GroupId Obtient ou définit l’identificateur du groupe d’utilisateurs requis pour exécuter les tâches associées au principal. (Put)
IPrincipal ::p ut_Id Obtient ou définit l'identificateur unique du principal. (Put)
IPrincipal ::p ut_LogonType Obtient ou définit la méthode d’ouverture de session de sécurité requise pour exécuter les tâches associées au principal. (Put)
IPrincipal ::p ut_RunLevel Obtient ou définit l’identificateur utilisé pour spécifier le niveau de privilège requis pour exécuter les tâches associées au principal. (Put)
IPrincipal ::p ut_UserId Obtient ou définit l’identificateur d’utilisateur requis pour exécuter les tâches associées au principal. (Put)

Remarques

Lorsque vous spécifiez un compte, n’oubliez pas d’utiliser correctement la double barre oblique inverse dans le code pour spécifier le domaine et le nom d’utilisateur. Par exemple, utilisez DOMAIN\UserName pour spécifier une valeur pour la propriété UserId .

Lors de la lecture ou de l’écriture de CODE XML pour une tâche, les informations d’identification de sécurité d’un principal sont spécifiées dans l’élément Principal du schéma du planificateur de tâches.

Si une tâche est inscrite à l’aide de l’outil en ligne de commande at.exe et que cette interface est utilisée pour récupérer des informations sur la tâche, la propriété LogonType renvoie 0, la propriété RunLevel renvoie 0 et la propriété UserId renvoie NULL.

Exemples

Pour plus d’informations et un exemple de code pour cette interface, consultez Time Trigger Example (C++) ou Registration Trigger Example (C++).

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	taskschd.h

Voir aussi

ITaskDefinition

Propriété principale de ITaskDefinition

Interfaces du planificateur de tâches