DOCUMENTATION EN LIGNE
DE WINDEVWEBDEV ET WINDEV MOBILE

Aide / WLangage / Fonctions WLangage / Fonctions standard / Fonctions de gestion de Windows / Fonctions Exécutables
WINDEV
WindowsLinuxUniversal Windows 10 AppJavaEtats et RequêtesCode Utilisateur (MCU)
WEBDEV
WindowsLinuxPHPWEBDEV - Code Navigateur
WINDEV Mobile
AndroidWidget AndroidiPhone/iPadWidget IOSApple WatchMac CatalystUniversal Windows 10 App
Autres
Procédures stockées
Lance depuis l'application en cours l'exécution d'un programme à distance. Cette application peut être lancée en utilisant un compte utilisateur spécifique. Cette application ne doit pas avoir d'interface.
Remarque : Le programme lancé à distance ne pourra pas accéder au réseau.
Exemple
// Lancement d'une application distante (utilisation avancée)
AppliALancer est un Processus
AppliALancer.Exécutable = "monappli.exe"
AppliALancer.LigneCommande = "/SILENT"
AppliALancer.LoginExécution = "DOMAINE\USER"
AppliALancer.MotDePasseExécution = "monmotdepasse"
 
LanceAppliDistante(AppliALancer, exeValeurRetour, "POSTE2")
TANTQUE AppliALancer.ExécutionEnCours = Vrai
Temporisation(100)
FIN
 
Trace(AppliALancer.ValeurDeRetour)
Syntaxe

Lancer une application distante avec le compte utilisateur courant Masquer les détails

<Résultat> = LanceAppliDistante(<Ligne de commande> , <Elément à renvoyer> , <Adresse du poste distant> [, <Login de connexion> [, <Mot de passe de connexion>]])
<Résultat> : Entier
Correspond aux informations demandées par le paramètre <Elément à renvoyer> :
  • si la constante exeValeurRetour a été spécifiée, <Résultat> correspond au code de retour spécifié avec l'instruction RENVOYER.
  • si la constante exePID a été spécifiée, <Résultat> correspond à l'identifiant du processus de l'application lancée (PID).
<Ligne de commande> : Chaîne de caractères
Ligne de commande à exécuter. L'application spécifiée doit être installée sur le poste distant. Les chemins utilisés dans cette ligne de commande doivent être valides sur le poste distant.
<Elément à renvoyer> : Constante de type Entier
Paramètre le résultat de la fonction :
exePIDLe programme en cours et le programme lancé s'exécutent en parallèle. <Résultat> correspond à l'identificateur du processus créé (également appelé PID) de l'exécutable, si celui-ci a été lancé, 0 en cas d'échec.
exeValeurRetourLe programme en cours reprend son exécution lorsque le programme lancé est terminé. <Résultat> correspond à la valeur de retour de l'exécutable.

Attention : L'application distante doit s'exécuter en moins d'une heure. Dans le cas contraire, la valeur renvoyée au bout d'une heure sera 0.
<Adresse du poste distant> : Chaîne de caractères
Adresse IP du poste serveur au format xxx.xxx.xxx.xxx (obtenu par la fonction NetAdresseIP) ou nom du poste serveur (obtenu par la fonction NetNomMachine).
<Login de connexion> : Chaîne de caractères optionnelle
Nom d'utilisateur à utiliser pour se connecter au poste distant. Ce paramètre est de la forme "Domaine\Utilisateur".
Si ce paramètre n'est pas précisé, le compte utilisateur courant est utilisé.
<Mot de passe de connexion> : Chaîne de caractères optionnelle
Mot de passe associé au paramètre <Login de connexion>.
Si le paramètre <Login de connexion> est précisé, ce paramètre est obligatoire.

Lancer une application distante (utilisation avancée) Masquer les détails

<Résultat> = LanceAppliDistante(<Processus> , <Elément à renvoyer> , <Adresse du poste distant> [, <Login de connexion> [, <Mot de passe de connexion>]])
<Résultat> : Entier
Correspond aux informations demandées par le paramètre <Elément à renvoyer> :
  • si la constante exeValeurRetour a été spécifiée, <Résultat> correspond au code de retour spécifié avec l'instruction RENVOYER.
  • si la constante exePID a été spécifiée, <Résultat> correspond à l'identifiant du processus de l'application lancée (PID).
<Processus> : Variable de type Processus
Variable de type Processus permettant de décrire les caractéristiques de l'application à exécuter.
<Elément à renvoyer> : Constante de type Entier
Paramètre le résultat de la fonction :
exePIDLe programme en cours et le programme lancé s'exécutent en parallèle. <Résultat> correspond à l'identificateur du processus créé (également appelé PID) de l'exécutable, si celui-ci a été lancé, 0 en cas d'échec.
exeValeurRetourLe programme en cours reprend son exécution lorsque le programme lancé est terminé. <Résultat> correspond à la valeur de retour de l'exécutable.

Attention : L'application distante doit s'exécuter en moins d'une heure. Dans le cas contraire, la valeur renvoyée au bout d'une heure sera 0.
<Adresse du poste distant> : Chaîne de caractères
Adresse IP du poste serveur au format xxx.xxx.xxx.xxx (obtenu par la fonction NetAdresseIP) ou nom du poste serveur (obtenu par la fonction NetNomMachine).
<Login de connexion> : Chaîne de caractères optionnelle
Nom d'utilisateur à utiliser pour se connecter au poste distant. Ce paramètre est de la forme "Domaine\Utilisateur".
Si ce paramètre n'est pas précisé, le compte utilisateur courant est utilisé.
<Mot de passe de connexion> : Chaîne de caractères optionnelle
Mot de passe associé au paramètre <Login de connexion>.
Si le paramètre <Login de connexion> est précisé, ce paramètre est obligatoire.
Composante : wd290std.dll
Version minimum requise
  • Version 15
Documentation également disponible pour…
Commentaires
Cliquez sur [Ajouter] pour publier un commentaire

Dernière modification : 25/05/2022

Signaler une erreur ou faire une suggestion | Aide en ligne locale