Méthode TaskService.Connect
Pour les scripts, se connecte à un ordinateur distant et associe tous les appels suivants sur cette interface à une session distante. Si le paramètre serverName est vide, cette méthode s’exécute sur l’ordinateur local. Si l’id utilisateur n’est pas spécifié, le jeton actuel est utilisé.
Syntaxe
TaskService.Connect( _
[ ByVal serverName ], _
[ ByVal user ], _
[ ByVal domain ], _
[ ByVal password ] _
)
Paramètres
-
serverName [in, facultatif]
-
Nom de l’ordinateur auquel vous souhaitez vous connecter. Si le paramètre serverName est vide, cette méthode s’exécute sur l’ordinateur local.
-
utilisateur [in, facultatif]
-
Nom d’utilisateur utilisé lors de la connexion à l’ordinateur. Si l’utilisateur n’est pas spécifié, le jeton actuel est utilisé.
-
domain [in, facultatif]
-
Domaine de l’utilisateur spécifié dans le paramètre utilisateur .
-
password [in, facultatif]
-
Mot de passe utilisé pour se connecter à l’ordinateur. Si le nom d’utilisateur et le mot de passe ne sont pas spécifiés, le jeton actuel est utilisé.
Valeur retournée
Cette méthode ne retourne pas de valeur.
Notes
La méthode TaskService.Connect doit être appelée avant d’appeler l’une des autres méthodes TaskService .
Si la méthode Connect échoue, vous pouvez collecter l’identificateur d’erreur pour trouver la signification de l’erreur. Le tableau suivant répertorie les identificateurs d’erreur et leurs descriptions.
| Identificateur d’erreur | Description |
|---|---|
| 0x80070005 | L’accès est refusé pour se connecter au service Planificateur de tâches. |
| 0x80041315 | Le service Planificateur de tâches n’est pas en cours d’exécution. |
| 0x8007000e | L’application ne dispose pas de suffisamment de mémoire pour terminer l’opération ou l’utilisateur, le mot de passe ou le domaine a au moins une valeur null et une valeur non null. |
| 53 | Cette erreur est retournée dans les situations suivantes :
|
| 50 | Les paramètres utilisateur, mot de passe ou domaine ne peuvent pas être spécifiés lors de la connexion à un ordinateur Windows XP ou Windows Server 2003 distant à partir d’un ordinateur Windows Vista. |
Si vous souhaitez vous connecter à un ordinateur Windows Vista distant à partir d’un Windows Vista, vous devez autoriser l’exception de pare-feu Gestion des tâches planifiées à distance sur l’ordinateur distant. Pour autoriser cette exception, cliquez sur Démarrer, Panneau de configuration, Sécurité, Autoriser un programme via le Pare-feu Windows, puis sélectionnez la zone Gestion des tâches planifiées à distance case activée. Cliquez ensuite sur le bouton Ok dans la boîte de dialogue Paramètres du pare-feu Windows.
Si vous vous connectez à un ordinateur Windows XP ou Windows Server 2003 distant à partir d’un ordinateur Windows Vista, vous devez autoriser l’exception de pare-feu Partage de fichiers et d’imprimantes sur l’ordinateur distant. Pour autoriser cette exception, cliquez sur Démarrer, Panneau de configuration, double-cliquez sur Pare-feu Windows, sélectionnez l’onglet Exceptions, puis sélectionnez l’exception de pare-feu Partage de fichiers et d’imprimantes. Cliquez ensuite sur le bouton OK dans la boîte de dialogue Pare-feu Windows. Le service Registre à distance doit également s’exécuter sur l’ordinateur distant.
Spécifications
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows Vista [applications de bureau uniquement] |
| Serveur minimal pris en charge |
Windows Server 2008 [applications de bureau uniquement] |
| Bibliothèque de types |
|
| DLL |
|