Metodo ITSRemoteProgram::ServerStartProgram

Articolo
06/13/2023

Specifica un programma RemoteApp da avviare nella sessione remota. Questa funzione deve essere richiamata in una sessione connessa (dopo la ricezione della notifica connessa alla sessione nel client). Qualsiasi numero di programmi RemoteApp può essere avviato in una sessione. Se non viene avviato alcun programma RemoteApp nella sessione entro il limite di timeout, si verifica il timeout di una sessione di RemoteApp, ovvero due minuti per Windows Server 2008.

Sintassi

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

Parametri

bstrExecutablePath [in]: Percorso del file eseguibile del programma RemoteApp nel server.
bstrFilePath [in]: Percorso di un file da aprire nel server tramite un'associazione di file, ad esempio "C:\\Documents\\MyReport.docx". Se si specifica bstrFilePath, non è necessario specificare il parametro bstrExecutablePath e viceversa. È consigliabile specificare solo uno dei parametri.
bstrWorkingDirectory [in]: Directory di lavoro nel server per il programma RemoteApp.
vbExpandEnvVarInWorkingDirectoryOnServer [in]: Indica se il server deve espandere le variabili di ambiente nel percorso della directory di lavoro. Impostare questo parametro su VARIANT_TRUE se il percorso della directory di lavoro contiene variabili di ambiente o VARIANT_FALSE se il percorso della directory di lavoro non contiene variabili di ambiente.
bstrArguments [in]: Argomenti della riga di comando per il programma RemoteApp specificato in bstrExecutablePath. Impostare questa proprietà su NULL se bstrExecutablePath non è specificato.
vbExpandEnvVarInArgumentsOnServer [in]: Indica se il server deve espandere le variabili di ambiente negli argomenti della riga di comando. Impostare questo parametro su VARIANT_TRUE se gli argomenti contengono variabili di ambiente o VARIANT_FALSE se gli argomenti non contengono variabili di ambiente.

Valore restituito

Restituisce S_OK in caso di esito positivo.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Libreria dei tipi	MsTscAx.dll
DLL	MsTscAx.dll
IID	IID_ITSRemoteProgram è definito come FDD029F9-467A-4c49-8529-64B521DBD1B4

Vedi anche

ITSRemoteProgram2
ITSRemoteProgram3
ITSRemoteProgram

Condividi tramite