ITaskTrigger ::SetTrigger, méthode (mstask.h)
[[Cette API peut être modifiée ou indisponible dans les versions ultérieures du système d’exploitation ou du produit. Utilisez plutôt les interfaces Du planificateur de tâches 2.0 .] ]
La méthode SetTrigger définit les critères de déclencheur pour un déclencheur de tâche.
Syntaxe
HRESULT SetTrigger(
[in] const PTASK_TRIGGER pTrigger
);
Paramètres
[in] pTrigger
Pointeur vers une structure TASK_TRIGGER qui contient les valeurs qui définissent le nouveau déclencheur de tâche.
Valeur retournée
La méthode SetTrigger retourne l’une des valeurs suivantes.
Code de retour | Description |
---|---|
|
L'opération a réussi. |
|
Les arguments ne sont pas valides. |
|
Mémoire disponible insuffisante. |
Remarques
Les membres wBeginDay, wBeginMonth et wBeginYear de la structure TASK_TRIGGER doivent être définis sur un jour, un mois et une année valides, respectivement.
Un nombre quelconque de déclencheurs peut être associé à une tâche. Les heures d’exécution de la tâche correspondent à l’union de tous les déclencheurs définis pour cette tâche.
Pour mettre à jour la tâche avec ces nouveaux paramètres de déclencheur, les applications doivent appeler la méthode IPersistFile ::Save après avoir appelé SetTrigger.
Exemples
Le code suivant montre la déclaration de variable et la syntaxe d’appel pour cette méthode, y compris les membres requis de TASK_TRIGGER. Définition des critères de déclencheur lors de la création d’un déclencheur, consultez Création d’un déclencheur.
HRESULT hr = S_OK;
TASK_TRIGGER Trigger;
ZeroMemory(&Trigger, sizeof(TASK_TRIGGER));
Trigger.cbTriggerSize = sizeof(TASK_TRIGGER);
Trigger.wBeginDay = 1;
Trigger.wBeginMonth = 1;
Trigger.wBeginYear = 1999;
// pITaskTrigger is a previously assigned ITaskTrigger pointer.
hr = pITaskTrigger->SetTrigger(&Trigger);
if (FAILED(hr))
{
printf("Failed SetTrigger\n");
exit(1);
}
Configuration requise
Condition requise | Valeur |
---|---|
Client minimal pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
Serveur minimal pris en charge | Windows 2000 Server [applications de bureau uniquement] |
Plateforme cible | Windows |
En-tête | mstask.h |
Bibliothèque | Mstask.lib |
DLL | Mstask.dll |
Composant redistribuable | Internet Explorer 4.0 ou version ultérieure sur Windows NT 4.0 et Windows 95 |
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