Méthode ITaskService::Connect (taskschd.h)

Article
08/26/2023

Se connecte à un ordinateur distant et associe tous les appels suivants sur cette interface à une session à distance. Si le paramètre serverName est vide, cette méthode s’exécute sur l’ordinateur local. Si l’utilisateur n’est pas spécifié, le jeton actuel est utilisé.

Syntaxe

HRESULT Connect(
  [in, optional] VARIANT serverName,
  [in, optional] VARIANT user,
  [in, optional] VARIANT domain,
  [in, optional] VARIANT password
);

Paramètres

[in, optional] serverName

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.

[in, optional] user

Nom d’utilisateur utilisé pendant la connexion à l’ordinateur. Si l’utilisateur n’est pas spécifié, le jeton actuel est utilisé.

[in, optional] domain

Domaine de l’utilisateur spécifié dans le paramètre utilisateur .

[in, optional] password

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 peut retourner l’une de ces valeurs.

Code/valeur de retour	Description
S_OK 0	L’opération s’est terminée avec succès.
E_ACCESS_DENIED 0x80070005	L’accès est refusé pour se connecter au service Planificateur de tâches.
SCHED_E_SERVICE_NOT_RUNNING 0x80041315	Le service Planificateur de tâches n’est pas en cours d’exécution.
E_OUTOFMEMORY 0x8007000e	L’application n’a pas 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.
ERROR_BAD_NETPATH 53	Cette erreur est retournée dans les situations suivantes : Le nom d’ordinateur spécifié dans le paramètre serverName n’existe pas. Lorsque vous essayez de vous connecter à un ordinateur Windows Server 2003 ou Windows XP, et que l’exception de pare-feu Partage de fichiers et d’imprimantes n’est pas activée sur l’ordinateur distant ou que le service Registre distant n’est pas en cours d’exécution. Lorsque vous essayez de vous connecter à un ordinateur Windows Vista, l’exception de pare-feu Gestion des tâches planifiées à distance n’est pas activée sur l’ordinateur distant et l’exception de pare-feu Partage de fichiers et d’imprimantes activée, ou le service Registre à distance n’est pas en cours d’exécution.
ERROR_NOT_SUPPORTED 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.

Remarques

La méthode ITaskService::Connect doit être appelée avant d’appeler l’une des autres méthodes ITaskService .

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 distant doit également s’exécuter sur l’ordinateur distant.

NoteITaskService::Connect peut retourner une erreur SCHED_E_INVALIDVALUE lors de la lecture de la définition de tâche si le schéma de la tâche distante n’est pas pris en charge par l’ordinateur actuel. Pour vérifier la version de schéma la plus élevée prise en charge par l’ordinateur actuel, case activée la propriété ITaskService::HighestVersion.

Configuration requise


Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	taskschd.h
Bibliothèque	Taskschd.lib
DLL	Taskschd.dll

Voir aussi

ITaskService

ITaskService::HighestVersion

Partager via