Méthode ITask ::SetApplicationName (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 affecte une application spécifique à la tâche actuelle.
Syntaxe
HRESULT SetApplicationName(
[in] LPCWSTR pwszApplicationName
);
Paramètres
[in] pwszApplicationName
Chaîne terminée par null qui contient le nom de l’application qui sera associée à la tâche. Utilisez une chaîne vide pour effacer le nom de l’application.
Valeur retournée
La méthode SetApplicationName 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
Si vous ne spécifiez pas de chemin d’accès pour l’application, le planificateur de tâches recherche le chemin d’accès de l’environnement pour trouver le chemin d’accès approprié. Si le nom de l’application spécifie un programme, celui-ci doit utiliser l’extension .exe pour s’assurer que l’interface utilisateur du planificateur de tâches affiche correctement l’icône de l’application.
Après avoir appelé SetApplicationName, veillez à appeler IPersistFile ::Save pour enregistrer la tâche modifiée sur le disque.
Exemples
Pour obtenir un exemple de définition du nom de l’application, consultez Exemple de code C/C++ : Définition du nom de l’application.
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 |