ITSRemoteProgram::ServerStartProgram-Methode

Artikel
06/13/2023

Gibt ein RemoteApp-Programm an, das in der Remotesitzung gestartet werden soll. Diese Funktion muss für eine verbundene Sitzung aufgerufen werden (nachdem die verbundene Sitzungsbenachrichtigung auf dem Client empfangen wurde). Eine beliebige Anzahl von RemoteApp-Programmen kann in einer Sitzung gestartet werden. Bei einer RemoteApp-Sitzung wird ein Timeout ausgeführt, wenn kein RemoteApp-Programm in der Sitzung innerhalb des Timeoutlimits gestartet wird, das für Windows Server 2008 zwei Minuten beträgt.

Syntax

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

Parameter

bstrExecutablePath [in]: Der Pfad der ausführbaren RemoteApp-Programmdatei auf dem Server.
bstrFilePath [in]: Der Pfad einer Datei, die auf dem Server über eine Dateizuordnung geöffnet werden soll, z. B. "C:\\Documents\\MyReport.docx". Wenn Sie bstrFilePath angeben, sollten Sie den bstrExecutablePath-Parameter nicht angeben und umgekehrt. Sie sollten nur einen der Parameter angeben.
bstrWorkingDirectory [in]: Das Arbeitsverzeichnis auf dem Server für das RemoteApp-Programm.
vbExpandEnvVarInWorkingDirectoryOnServer [in]: Gibt an, ob der Server Umgebungsvariablen im Arbeitsverzeichnispfad erweitern soll. Legen Sie diesen Parameter auf VARIANT_TRUE fest, wenn der Arbeitsverzeichnispfad Umgebungsvariablen enthält, oder VARIANT_FALSE , wenn der Arbeitsverzeichnispfad keine Umgebungsvariablen enthält.
bstrArguments [in]: Die Befehlszeilenargumente für das RemoteApp-Programm, die in bstrExecutablePath angegeben sind. Legen Sie dies auf NULL fest, wenn bstrExecutablePath nicht angegeben ist.
vbExpandEnvVarInArgumentsOnServer [in]: Gibt an, ob der Server Umgebungsvariablen in den Befehlszeilenargumenten erweitern soll. Legen Sie diesen Parameter auf VARIANT_TRUE fest, wenn die Argumente Umgebungsvariablen enthalten, oder VARIANT_FALSE , wenn die Argumente keine Umgebungsvariablen enthalten.

Rückgabewert

Gibt bei erfolgreicher Ausführung S_OK zurück.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Unterstützte Mindestversion (Server)	WindowsServer 2008
Typbibliothek	MsTscAx.dll
DLL	MsTscAx.dll
IID	IID_ITSRemoteProgram ist definiert als FDD029F9-467A-4c49-8529-64B521DBD1B4

Siehe auch

ITSRemoteProgram2
ITSRemoteProgram3
ITSRemoteProgram

Freigeben über