TaskService. méthode Connecter
Pour les scripts, se connecte à un ordinateur distant et associe tous les appels suivants à cette interface avec une session à distance. Si le paramètre serverName est vide, cette méthode s’exécute sur l’ordinateur local. Si le userId n’est pas spécifié, le jeton actuel est utilisé.
Syntaxe
TaskService.Connect( _
[ ByVal serverName ], _
[ ByVal user ], _
[ ByVal domain ], _
[ ByVal password ] _
)
Paramètres
-
nom du serveur [ dans, 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 [ dans, facultatif]
-
Nom d’utilisateur utilisé lors de la connexion à l’ordinateur. Si l’utilisateur n’est pas spécifié, le jeton actuel est utilisé.
-
domaine [ dans, facultatif]
-
Domaine de l’utilisateur spécifié dans le paramètre User .
-
mot de passe [ dans, 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 de retour
Cette méthode ne retourne pas de valeur.
Remarques
la méthode TaskService. Connecter doit être appelée avant d’appeler l’une des autres méthodes TaskService .
si la méthode Connecter échoue, vous pouvez collecter l’identificateur d’erreur pour déterminer 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 la connexion 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 passeou le domaine a au moins une valeur null et une valeur non null. |
| 53 | Cette erreur est retournée dans les cas suivants :
|
| 50 | les paramètres utilisateur, mot de passeou domaine ne peuvent pas être spécifiés lors de la connexion à un ordinateur distant Windows XP ou Windows Server 2003 à partir d’un ordinateur Windows Vista. |
si vous vous connectez à un ordinateur distant Windows vista à partir d’un Windows vista, vous devez autoriser l’exception de pare-feu de 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 Windows pare-feu, puis activez la case à cocher gestion des tâches planifiées distantes. cliquez ensuite sur le bouton Ok dans la boîte de dialogue Windows Paramètres du pare-feu.
si vous vous connectez à un ordinateur distant Windows XP ou Windows Server 2003 à partir d’un ordinateur Windows Vista, vous devez autoriser l’exception de pare-feu de partage de fichiers et d’imprimantes sur l’ordinateur distant. pour autoriser cette exception, cliquez sur démarrer, panneau de configuration, double-cliquez sur Windows pare-feu, sélectionnez l’onglet Exceptions, puis sélectionnez l’exception pare-feu de partage de fichiers et d’imprimantes. cliquez ensuite sur le bouton OK dans la boîte de dialogue Windows le pare-feu. Le service d’accès à distance au registre doit également être en cours d’exécution sur l’ordinateur distant.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge |
Windows [Applications de bureau Vista uniquement] |
| Serveur minimal pris en charge |
Windows Serveur 2008 [ applications de bureau uniquement] |
| Bibliothèque de types |
|
| DLL |
|