Méthode ITaskScheduler ::Activate (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 Activate retourne une interface active pour un élément de travail spécifié.
Syntaxe
HRESULT Activate(
[in] LPCWSTR pwszName,
[in] REFIID riid,
[out] IUnknown **ppUnk
);
Paramètres
[in] pwszName
Chaîne terminée par null qui spécifie le nom de l’élément de travail à activer.
[in] riid
Identificateur qui identifie l’interface demandée. La seule interface prise en charge pour l’instant, ITask, a l’identificateur IID_ITask.
[out] ppUnk
Pointeur vers un pointeur d’interface qui reçoit l’adresse de l’interface demandée.
Valeur retournée
Lorsque cette méthode réussit, S_OK est retourné.
Si la méthode échoue, l’un des codes d’erreur suivants peut être retourné.
| Code de retour | Description |
|---|---|
|
La tâche n’existe pas. |
|
Le paramètre pwszName n’est pas valide. |
|
Une allocation de mémoire a échoué. |
|
La version de l’objet de tâche n’est pas prise en charge ou n’est pas valide. |
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 |