Méthode ITask ::SetParameters (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 .] ]

Cette méthode définit les paramètres de ligne de commande de la tâche.

Syntaxe

HRESULT SetParameters(
  [in] LPCWSTR pwszParameters
);

Paramètres

[in] pwszParameters

Chaîne terminée par null qui contient des paramètres de tâche. Ces paramètres sont passés en tant qu’arguments de ligne de commande à l’application que la tâche exécutera. Pour effacer la propriété de paramètre de ligne de commande, définissez pwszParameters sur L" ».

Valeur retournée

La méthode SetParameters retourne l’une des valeurs suivantes.

Code de retour Description
S_OK
 L'opération a réussi.
E_INVALIDARG
 Les arguments ne sont pas valides.
E_OUTOFMEMORY
 Mémoire disponible insuffisante.

Remarques

Si une application est associée à la tâche, les paramètres de tâche définis par cette méthode sont ignorés.

Après avoir défini les paramètres de la tâche, veillez à appeler IPersistFile ::Save pour enregistrer l’objet de tâche modifié sur le disque.

Exemples

Pour obtenir un exemple de définition des paramètres, consultez Exemple de code C/C++ : Définition des paramètres de tâche.

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