MÉTHODE ITSRemoteProgram::ServerStartProgram

Article
06/13/2023

Spécifie un programme RemoteApp à démarrer dans la session à distance. Cette fonction doit être appelée sur une session connectée (une fois la notification connectée de session reçue au client). Vous pouvez démarrer n’importe quel nombre de programmes RemoteApp dans une session. Une session RemoteApp expire si aucun programme RemoteApp n’est démarré dans la session dans la limite de délai d’attente, qui est de deux minutes pour Windows Server 2008.

Syntaxe

HRESULT ServerStartProgram(
  [in] BSTR         bstrExecutablePath,
  [in] BSTR         bstrFilePath,
  [in] BSTR         bstrWorkingDirectory,
  [in] VARIANT_BOOL vbExpandEnvVarInWorkingDirectoryOnServer,
  [in] BSTR         bstrArguments,
  [in] VARIANT_BOOL vbExpandEnvVarInArgumentsOnServer
);

Paramètres

bstrExecutablePath [in]: Chemin du fichier exécutable du programme RemoteApp sur le serveur.
bstrFilePath [in]: Chemin d’accès d’un fichier à ouvrir sur le serveur via une association de fichiers, par exemple « C:\\Documents\\MyReport.docx ». Si vous spécifiez bstrFilePath, vous ne devez pas spécifier le paramètre bstrExecutablePath , et vice versa. Vous ne devez spécifier qu’un seul des paramètres.
bstrWorkingDirectory [in]: Répertoire de travail sur le serveur pour le programme RemoteApp.
vbExpandEnvVarInWorkingDirectoryOnServer [in]: Indique si le serveur doit développer les variables d’environnement dans le chemin du répertoire de travail. Définissez ce paramètre sur VARIANT_TRUE si le chemin du répertoire de travail contient des variables d’environnement, ou VARIANT_FALSE si le chemin du répertoire de travail ne contient pas de variables d’environnement.
bstrArguments [in]: Arguments de ligne de commande pour le programme RemoteApp spécifiés dans bstrExecutablePath. Définissez cette valeur sur NULL si bstrExecutablePath n’est pas spécifié.
vbExpandEnvVarInArgumentsOnServer [in]: Indique si le serveur doit développer les variables d’environnement dans les arguments de ligne de commande. Définissez ce paramètre sur VARIANT_TRUE si les arguments contiennent des variables d’environnement, ou VARIANT_FALSE si les arguments ne contiennent pas de variables d’environnement.

Valeur retournée

Retourne S_OK en cas de réussite.

Spécifications

Condition requise	Valeur
Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
Bibliothèque de types	MsTscAx.dll
DLL	MsTscAx.dll
IID	IID_ITSRemoteProgram est défini comme étant FDD029F9-467A-4c49-8529-64B521DBD1B4

Voir aussi

ITSRemoteProgram2
ITSRemoteProgram3
ITSRemoteProgram

Partager via