Histórico da Página
...
Executa uma função, um arquivo ou qualquer execução em linha de comando no S.O. na estação onde o Smartclient está em execução. Esta função encontra-se disponível para Windows e Linux.
Sintaxe
Bloco de código | ||
---|---|---|
| ||
ShellExecute( < cAcao >, < cArquivo >, < cParam >, < 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.
nRet | numérico | Se a função for bem-sucedida ela retornará um valor maior que 32. O retorno bem sucedido (superior a 32) é de responsabilidade do Sistema Operacional,e será necessário pesquisar o comando executado para confirmar essa informação. Se a função falhar ela retornará um valor de erro entre 0 e 32, que indica a causa da falha. O valor de retorno é lançado como um HINSTANCE, conforme tabela de erros disponível abaixo: https://docs.microsoft.com/en-us/windows/win32/api/shellapi/ns-shellapi-shellexecuteinfoa SE_ERR_FNF (2) SE_ERR_PNF (3) SE_ERR_ACCESSDENIED (5) SE_ERR_OOM (8) SE_ERR_SHARE (26) SE_ERR_ASSOCINCOMPLETE (27) SE_ERR_DDETIMEOUT (28) SE_ERR_DDEFAIL (29) SE_ERR_DDEBUSY (30) SE_ERR_NOASSOC (31) SE_ERR_DLLNOTFOUND (32) |
Observações
Informações | ||||
---|---|---|---|---|
| ||||
Opções de exibição da janela da aplicação executada: |
Nota | ||||
---|---|---|---|---|
| ||||
|
Exemplos
Bloco de código | ||||||||||
---|---|---|---|---|---|---|---|---|---|---|
| ||||||||||
#INCLUDE "TOTVS.CH" user function exemplo() // Exemplo de uso para Windows shellExecuteShellExecute( "Openopen", "C:\Windows\System32\cmd.exehttp://www.google.com.br", "", "", 1 ) /k dir // Exemplo de uso para Linux shellExecute("Browser", "/usr/bin/firefox", "C:\http://www.google.com.br", "/", 1 ) return |
Abrangência
TOTVS Application Server
Veja também
...