Método ITSRemoteProgram::ServerStartProgram

Artigo
06/12/2023

Especifica um programa RemoteApp a ser iniciado na sessão remota. Essa função deve ser invocada em uma sessão conectada (depois que a notificação conectada da sessão é recebida no cliente). Qualquer número de programas RemoteApp pode ser iniciado em uma sessão. Uma sessão do RemoteApp terá um tempo limite se nenhum programa RemoteApp for iniciado na sessão dentro do limite de tempo limite, que é de dois minutos para o Windows Server 2008.

Sintaxe

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

Parâmetros

bstrExecutablePath [in]: O caminho do arquivo executável do programa RemoteApp no servidor.
bstrFilePath [in]: O caminho de um arquivo a ser aberto no servidor por meio de uma associação de arquivos, por exemplo, "C:\\Documents\\MyReport.docx". Se você especificar bstrFilePath, não deverá especificar o parâmetro bstrExecutablePath e vice-versa. Você deve especificar apenas um dos parâmetros.
bstrWorkingDirectory [in]: O diretório de trabalho no servidor do programa RemoteApp.
vbExpandEnvVarInWorkingDirectoryOnServer [in]: Indica se o servidor deve expandir variáveis de ambiente no caminho do diretório de trabalho. Defina esse parâmetro como VARIANT_TRUE se o caminho do diretório de trabalho contiver variáveis de ambiente ou VARIANT_FALSE se o caminho do diretório de trabalho não contiver variáveis de ambiente.
bstrArguments [in]: Os argumentos de linha de comando para o programa RemoteApp especificados em bstrExecutablePath. Defina isso como NULL se bstrExecutablePath não for especificado.
vbExpandEnvVarInArgumentsOnServer [in]: Indica se o servidor deve expandir variáveis de ambiente nos argumentos de linha de comando. Defina esse parâmetro como VARIANT_TRUE se os argumentos contiverem variáveis de ambiente ou VARIANT_FALSE se os argumentos não contiverem variáveis de ambiente.

Valor retornado

Retorna S_OK se tiver êxito.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Biblioteca de tipos	MsTscAx.dll
DLL	MsTscAx.dll
IID	IID_ITSRemoteProgram é definido como FDD029F9-467A-4c49-8529-64B521DBD1B4

Confira também

ITSRemoteProgram2
ITSRemoteProgram3
ITSRemoteProgram