Méthode ITask ::SetWorkingDirectory (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 .] ]
Cette méthode définit le répertoire de travail de la tâche.
Syntaxe
HRESULT SetWorkingDirectory(
[in] LPCWSTR pwszWorkingDirectory
);
Paramètres
[in] pwszWorkingDirectory
Chaîne terminée par null qui contient un chemin d’accès au répertoire de travail de la tâche.
L’application commence par ce répertoire en tant que répertoire de travail actuel. Pour effacer le répertoire, définissez pwszWorkingDirectory sur L" ». Si le répertoire de travail est défini sur L », lorsque l’application est exécutée, le répertoire actif est le répertoire dans lequel réside l’exécutable du service planificateur de tâches, Mstask.exe.
Valeur retournée
La méthode SetWorkingDirectory 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
Après avoir défini le répertoire de travail d’une 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 du répertoire de travail d’une tâche, consultez Exemple de code C/C++ : Définition du répertoire de travail.
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 |