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 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] 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. Si elles sont présentes, 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 certains utilisateurs et groupes d’accès à une tâche.
[out] ppTask
Interface IRegisteredTask qui représente la nouvelle tâche.
Passez une référence à un pointeur d’interface NULLIRegisteredTa sk. Le référencement d’un pointeur NULL non
Valeur de retour
Cette méthode peut retourner l’une de ces valeurs.
Retourner le code/la valeur | 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 suffisamment de mémoire pour terminer l’opération ou l’utilisateur |
|
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 pas tous les déclencheurs spécifiés démarrent 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 que la tâche a un type d’ouverture de session interactif. Pour définir le type d’ouverture de session de tâche de manière interactive, spécifiez TASK_LOGON_INTERACTIVE_TOKEN ou TASK_LOGON_GROUP dans la propriété LogonType du principal de 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 un groupe spécifié dans le paramètre userId
La transmission des valeurs TASK_VALIDATE_ONLY et TASK_IGNORE_REGISTRATION_TRIGGERS aux indicateurs est un argument non valide.
La méthode
Si une tâche définit un réseau qui n’existe pas dans les paramètres de NetworkSettings de la tâche, la méthode ITaskFolder ::RegisterTaskDefinition retourne une erreur 0x8000ffff lors de l’inscription de la tâche.
Exigences
Exigence | Valeur |
---|---|
client minimum pris en charge | Windows Vista [applications de bureau uniquement] |
serveur minimum pris en charge | Windows Server 2008 [applications de bureau uniquement] |
plateforme cible | Windows |
d’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