ITaskFolder ::RegisterTask, méthode (taskschd.h)
Inscrit (crée) une tâche dans le dossier à l’aide de XML pour définir la tâche.
Syntaxe
HRESULT RegisterTask(
[in] BSTR path,
[in] BSTR xmlText,
[in] LONG flags,
[in] VARIANT userId,
[in] VARIANT password,
[in] TASK_LOGON_TYPE logonType,
[in, optional] VARIANT sddl,
[out] IRegisteredTask **ppTask
);
Paramètres
[in] path
Nom de la tâche. Si cette valeur est NULL, la tâche sera inscrite dans le dossier de tâches racine et le nom de la tâche sera une valeur GUID créée par le service Planificateur de tâches.
Un nom de tâche ne peut pas commencer ou se terminer par un caractère d’espace. Le caractère « . » ne peut pas être utilisé pour spécifier le dossier de tâches actuel et le « .. » les caractères ne peuvent pas être utilisés pour spécifier le dossier de tâches parent dans le chemin d’accès.
[in] xmlText
Définition au format XML de la tâche.
Les rubriques suivantes contiennent des tâches définies à l’aide de XML.
- Exemple de déclencheur de temps (XML)
- Exemple de déclencheur d’événement (XML)
- Exemple de déclencheur quotidien (XML)
- Exemple de déclencheur d’inscription (XML)
- Exemple de déclencheur hebdomadaire (XML)
- Exemple de déclencheur logon (XML)
- Exemple de déclencheur de démarrage (XML)
[in] flags
Constante TASK_CREATION .
[in] userId
Informations d’identification utilisateur utilisées pour inscrire la tâche.
[in] password
Mot de passe du userId utilisé pour inscrire la tâche. Lorsque le type d’ouverture de session TASK_LOGON_SERVICE_ACCOUNT est utilisé, le mot de passe doit être une valeur VARIANT vide telle que VT_NULL ou VT_EMPTY.
[in] logonType
Valeur qui définit la technique d’ouverture de session utilisée pour exécuter la tâche inscrite.
[in, optional] sddl
Descripteur de sécurité associé à la tâche inscrite. Vous pouvez spécifier la liste de contrôle d’accès (ACL) dans le descripteur de sécurité d’une tâche afin d’autoriser ou de refuser l’accès à une tâche à certains utilisateurs et groupes.
[out] ppTask
Interface IRegisteredTask qui représente la nouvelle tâche.
Transmettez une référence à un pointeur d’interface NULLIRegisteredTask . Le référencement d’un pointeur non NULL peut provoquer une fuite de mémoire, car le pointeur sera remplacé.
Valeur retournée
Cette méthode peut retourner l’une de ces valeurs.
Code/valeur de retour | Description |
---|---|
|
L’opération s’est terminée avec succès. |
|
L’accès est refusé pour se connecter au service Planificateur de tâches. |
|
L’application ne dispose pas de suffisamment de mémoire pour terminer l’opération ou l’utilisateur ou le mot de passe a au moins une valeur null et une valeur non null. |
|
La tâche est inscrite, mais peut ne pas démarrer. Le privilège d’ouverture de session batch doit être activé pour le principal de tâche. |
|
La tâche est inscrite, mais tous les déclencheurs spécifiés ne démarrent pas la tâche. |
Remarques
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.
Seul un membre du groupe Administrateurs peut créer une tâche avec un déclencheur de démarrage.
Vous pouvez inscrire une tâche avec succès avec un groupe spécifié dans le paramètre userId et TASK_LOGON_INTERACTIVE_TOKEN spécifié dans le paramètre logonType de ITaskFolder ::RegisterTask ou ITaskFolder ::RegisterTaskDefinition, mais la tâche ne s’exécutera pas.
Le passage des valeurs TASK_VALIDATE_ONLY et TASK_IGNORE_REGISTRATION_TRIGGERS au paramètre flags n’est pas un argument non valide.
Si une tâche définit un réseau qui n’existe pas dans les paramètres NetworkSettings de la tâche, la méthode ITaskFolder ::RegisterTask retourne l’erreur 0x8000ffff lorsque la tâche est inscrite.
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
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour