Page tree
Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 8 Next »

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.

Sintaxe

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.

Observações

Observação

Opções de exibição da janela da aplicação executada:
0 - Escondido
1 - Normal
2 - Minimizada
3 - Maximizada
4 - Na Ativação
5 - Mostra na posição mais recente da janela
6 - Minimizada
7 - Minimizada
8 - Esconde a barra de tarefas
9 - Restaura a posição anterior
10 - Posição padrão da aplicação
11 - Força minimização independente da aplicação executada, maximizada

Atenção

  • 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

user function exemplo()
 
    shellExecute("Open", "C:\Windows\System32\cmd.exe", " /k dir", "C:\", 1 )
 
return

Abrangência

TOTVS Application Server

Veja também

 

  • No labels