Méthode IPrincipal ::p ut_LogonType (taskschd.h)
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 put_LogonType(
TASK_LOGON_TYPE logon
);
Paramètres
logon
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 Task Scheduler.
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 interactif. 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 :
- 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)
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 |