Partager via


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
S_OK
L'opération a réussi.
E_INVALIDARG
Les arguments ne sont pas valides.
E_OUTOFMEMORY
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

Voir aussi

GetApplicationName

Itask