Méthode ITaskScheduler ::SetTargetComputer (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 SetTargetComputer sélectionne l’ordinateur sur lequel l’interface ITaskScheduler fonctionne, ce qui permet la gestion et l’énumération des tâches à distance.

Syntaxe

HRESULT SetTargetComputer(
  [in] LPCWSTR pwszComputer
);

Paramètres

[in] pwszComputer

Pointeur vers une chaîne de caractères larges terminée par un caractère null qui spécifie le nom de l’ordinateur cible pour le instance actuel de l’interface ITaskScheduler. Spécifiez le nom de l’ordinateur cible au format UNC (Universal Naming Convention). Pour indiquer l’ordinateur local, définissez cette valeur sur NULL ou sur le nom UNC de l’ordinateur local.

Note Lorsque vous spécifiez un nom d’ordinateur distant, utilisez deux barres obliques inverses (\\) avant le nom de l’ordinateur. Par exemple, utilisez « \\ComputerName » au lieu de « ComputerName ».
 

Valeur retournée

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

Code de retour Description
S_OK
 La méthode a réussi.
SCHED_E_SERVICE_NOT_INSTALLED
 Le service Planificateur de tâches n’est pas installé sur l’ordinateur cible.
E_ACCESS_DENIED
 L’utilisateur n’a pas accès à l’ordinateur distant.
E_INVALIDARG
 Le paramètre pwszComputer n’est pas valide.
E_OUTOFMEMORY
 Un échec d’allocation de mémoire s’est produit.

Remarques

Pour qu’un ordinateur Windows Server 2003 ou Windows XP crée, surveille ou contrôle des tâches sur un ordinateur Windows Vista, les opérations suivantes doivent être effectuées sur l’ordinateur Windows Vista, et l’utilisateur qui appelle la méthode ITaskScheduler ::SetTargetComputer doit être membre du groupe Administrateurs sur l’ordinateur Windows Vista distant.

Activer l’exception « Partager des fichiers et des imprimantes » dans le Pare-feu Windows

  1. Cliquez sur Démarrer, puis sur Panneau de configuration.
  2. Dans Panneau de configuration, cliquez sur Affichage classique, puis double-cliquez sur l’icône Pare-feu Windows.
  3. Dans la fenêtre Pare-feu Windows, cliquez sur l’onglet Exceptions, puis sélectionnez Exception de partage de fichiers et d’imprimantes case activée zone.

Activer le service « Registre distant »

  • Ouvrez une fenêtre d’invite de commandes et entrez la commande suivante : net start " Remote Registry »

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003 [applications de bureau uniquement]
Plateforme cible Windows
En-tête mstask.h
Bibliothèque Mstask.lib
DLL Mstask.dll

Voir aussi

ITaskScheduler