Méthode ITaskScheduler ::Activate (mstask.h)

  • Article

[[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
COR_E_FILENOTFOUND
 La tâche n’existe pas.
E_INVALIDARG
 Le paramètre pwszName n’est pas valide.
E_OUTOFMEMORY
 Une allocation de mémoire a échoué.
SCHED_E_UNKNOWN_OBJECT_VERSION
 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

Voir aussi

Itask

ITaskScheduler