Método ITSRemoteProgram::ServerStartProgram
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 |
|
| DLL |
|
| IID |
IID_ITSRemoteProgram é definido como FDD029F9-467A-4c49-8529-64B521DBD1B4 |