ITaskFolder ::RegisterTaskDefinition, méthode (taskschd.h)
Inscrit (crée) une tâche à un emplacement spécifié à l’aide de l’interface ITaskDefinition pour définir une tâche.
Syntaxe
HRESULT RegisterTaskDefinition(
[in] BSTR path,
[in] ITaskDefinition *pDefinition,
[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 est inscrite dans le dossier de tâches racine et le nom de la tâche est 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 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] pDefinition
Définition de la tâche inscrite.
[in] flags
Constante TASK_CREATION .
[in] userId
Informations d’identification de l’utilisateur utilisées pour inscrire la tâche. Le cas échéant, ces informations d’identification sont prioritaires sur les informations d’identification spécifiées dans l’objet de définition de tâche pointé par le paramètre pDefinition .
[in] password
Mot de passe de l’id utilisateur 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
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 IRegisteredTaskNULL. Le référencement d’un pointeur non NULL peut entraîner 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 n’a pas assez 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 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.
Seul un membre du groupe Administrateurs peut créer une tâche avec un déclencheur de démarrage.
Vous pouvez inscrire correctement une tâche 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écute pas.
Le passage des valeurs TASK_VALIDATE_ONLY et TASK_IGNORE_REGISTRATION_TRIGGERS au paramètre flags n’est pas un argument non valide.
La méthode ITaskFolder ::RegisterTaskDefinition retourne une erreur 80070534 lorsqu’elle est appelée par le compte Système avec le paramètre utilisateur égal à NULL, le paramètre de mot de passe égal à NULL et le paramètre logonType égal à TASK_LOGON_SERVICE_ACCOUNT.
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 ::RegisterTaskDefinition renvoie l’erreur 0x8000ffff lors de l’inscription de la tâche.
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