Executa e aguarda pelo término de um programa externo (arquivo executável) através do sistema operacional da estação onde o SmartClient está sendo executado.
Sintaxe
WaitRun( < cExeName >, [ nOpc ] )
Parâmetros
Nome | Tipo | Descrição | Obrigatório | Referência |
|---|---|---|---|---|
cExeName | caractere | Indica o nome e extensão do arquivo executável. | 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
- A função WaitRun() 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 partir de 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ção ou inexistência do arquivo executável, será retornado status 2.
- No Windows 10, aplicações UWP podem não respeitar o WaitRun() e o programa ser aberto e continuar rodando as instruções advpl antes mesmo de ser fechado.
Exemplos
#define SW_HIDE 0 // Escondido
#define SW_SHOWNORMAL 1 // Normal
#define SW_NORMAL 1 // Normal
#define SW_SHOWMINIMIZED 2 // Minimizada
#define SW_SHOWMAXIMIZED 3 // Maximizada
#define SW_MAXIMIZE 3 // Maximizada
#define SW_SHOWNOACTIVATE 4 // Na Ativação
#define SW_SHOW 5 // Mostra na posição mais recente da janela
#define SW_MINIMIZE 6 // Minimizada
#define SW_SHOWMINNOACTIVE 7 // Minimizada
#define SW_SHOWNA 8 // Esconde a barra de tarefas
#define SW_RESTORE 9 // Restaura a posição anterior
#define SW_SHOWDEFAULT 10// Posição padrão da aplicação
#define SW_FORCEMINIMIZE 11// Força minimização independente da aplicação executada
#define SW_MAX 11// Maximizada
User Function WinCalc()
Alert("Vou executar a calculadora.")
WaitRun("CALC.EXE", SW_SHOWNORMAL )
Alert("A calculadora foi encerrada.")
Return
Abrangência
TOTVS Application Server
Veja também
Visão Geral
Import HTML Content
Conteúdo das Ferramentas
Tarefas