Méthode IPrincipal ::get_LogonType (taskschd.h)

  • Article

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.

Cette propriété est en lecture/écriture.

Syntaxe

HRESULT get_LogonType(
  TASK_LOGON_TYPE *pLogon
);

Paramètres

pLogon

Valeur de retour

None

Remarques

Cette propriété est valide uniquement lorsqu’un identificateur d’utilisateur est spécifié par la propriété UserId .

Lors de la lecture ou de l’écriture de code XML pour une tâche, le type d’ouverture de session est spécifié dans l’élément <LogonType> du schéma du planificateur de tâches.

Pour une tâche qui contient une action de boîte de message, la zone de message s’affiche si la tâche est activée et si la tâche a un type d’ouverture de session interactive. Pour définir le type d’ouverture de session de la tâche de manière interactive, spécifiez TASK_LOGON_INTERACTIVE_TOKEN ou TASK_LOGON_GROUP dans la propriété LogonType du principal de la tâche, ou dans le paramètre logonType de ITaskFolder ::RegisterTask ou ITaskFolder ::RegisterTaskDefinition.

Lorsque l’économiseur de batterie est activé, les tâches du planificateur de tâches Windows sont déclenchées uniquement si la tâche est la suivante :

  • Non défini sur Démarrer la tâche uniquement si l’ordinateur est inactif... (la tâche n’utilise pas IdleSettings)
  • Non défini pour s’exécuter pendant la maintenance automatique (la tâche n’utilise pas MaintenanceSettings)
  • Est défini sur Exécuter uniquement lorsque l’utilisateur est connecté (la tâche LogonType est TASK_LOGON_INTERACTIVE_TOKEN ou TASK_LOGON_GROUP)
Tous les autres déclencheurs sont retardés jusqu’à ce que l’économiseur de batterie soit désactivé. Pour plus d’informations sur l’accès à l’état de l’économiseur de batterie dans votre application, consultez SYSTEM_POWER_STATUS. Pour obtenir des informations générales sur l’économiseur de batterie, consultez Économiseur de batterie (dans les instructions relatives aux composants matériels).

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
Bibliothèque Taskschd.lib
DLL Taskschd.dll

Voir aussi

IPrincipal

Planificateur de tâches