Histórico da Página
Composition Setup |
---|
import.css=/download/attachments/6062824/tecnologia.css |
|
Pagetitle |
---|
...
|
...
|
Executa uma função, um arquivo ou qualquer execução em linha de comando no S.O..
Sintaxe
Bloco de código | ||||
---|---|---|---|---|
| ||||
ShellExecute( <cAcao> cAcao >, <cArquivo> cArquivo >, <cParam> cParam >, <cDirTrabalho>, < nOpc> ) --> Nil cDirTrabalho >, [ nOpc ] )
|
Parâmetros
Nome | Tipo | Descrição | Obrigatório | Referência |
---|---|---|---|---|
cAcao |
...
caractere | Indica o nome da ação que será executada. | X |
|
cArquivo |
...
caractere | Indica o caminho |
...
e diretório do arquivo que será executado. | X |
|
cParam |
...
caractere | Indica o parâmetro de linha que será repassado para o executável. | X |
|
cDirTrabalho |
...
caractere | Indica o diretório de trabalho onde o arquivo será executa. | X |
|
nOpc |
...
numérico | Indica |
...
o modo de interface a ser criado para a execução do programa. Para mais informações consulte observações. |
|
|
Retorno
Nome | Tipo | Descrição |
---|---|---|
cRet | caractere | Retorna 0 (zero) em caso de sucesso da execução do processo e diferente de zero para erros. |
Observações
Informações | ||||
---|---|---|---|---|
| ||||
Opções de exibição da janela da aplicação executada: |
Nota | |||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|
|
Informações | ||
---|---|---|
| ||
// Tabela de opções de exibição da janela da aplicação executada |
- A função somente será executada caso o client (SmartClient) esteja executando em sistemas operacionais Microsoft Windows (a partir da versão XP), ou em caso de SmartClient HTML ou SmartClient Activex.
- Existe suporte a variáveis de ambiente nos parâmetros cArquivo
- e cDirTrabalho em builds superiores a 7.00.111010P. Ex:
ShellExecute( "Open", "%PROGRAMFILES%\Internet Explorer\iexplore.exe", "http://www.google.com.br", "C:\", 1 )
- Quando executada via SmartClient HTML, a função ShellExecute não tem acesso ao arquivos locais, só podendo ser utilizada para abrir URL de sites em outras janelas/abas. Ex:
Exemplo: ShellExecute( "Open", "http://www.google.com.br", "", "C:\", 1 )
- A função ShellExecute() deve ser chamada de um programa AdvPL que está sendo executado a partir de uma conexão do Smart Client. Caso a função seja chamada a partirde um processo que não foi iniciado a partir do Smart Client, por exemplo uma função em JOB, a função não executará o programa e retornará -1. Em caso de falha na localizaçãoou inexistência do arquivo executável, será retornado status 2.
Exemplos
Bloco de código | ||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|
| title
| Exemplo
| linenumbers
| true
| ||||||||
user function exemplo()
shellExecute("Open", "C:\Windows\System32\cmd.exe", " /k dir", "C:\", 1 ) return
|
Abrangência
TOTVS Application Server
Veja também