cPontoEntradaCaracterObligatorio
Nome do ponto de entrada ou bloco a executar.
FUNCIóNPublicado
ExecBlock
ExecBlock( <cPontoEntrada>, [lMostraErro], [lRetorna], [aParametros] ) --> uRetEjecuta un punto de entrada o bloque personalizado del entorno Protheus.
Descripción general
ExecBlock() llama una personalización registrada en el entorno. Es un mecanismo clásico de extensión de Protheus: la rutina estándar verifica o ejecuta un punto de entrada para permitir validaciones y comportamientos específicos sin alterar el fuente estándar.
Sintaxis
ExecBlock( <cPontoEntrada>, [lMostraErro], [lRetorna], [aParametros] ) --> uRetParámetros
lMostraErroLógicoOpcional
Indica tratamento/exibição de erro conforme o padrão do ambiente.
lRetornaLógicoOpcional
Indica se a chamada deve considerar retorno do bloco executado, conforme contrato da rotina.
aParametrosArrayOpcional
Parâmetros enviados ao ponto de entrada, quando previstos pelo contrato.
Execução com validação de retorno
#Include "TOTVS.ch"
User Function ExExecBlock()
Local lContinuar := .T.
If ExistBlock("MA030VLD")
lContinuar := ExecBlock("MA030VLD", .F., .F.)
EndIf
If !lContinuar
MsgStop("Validación interrumpida por el punto de entrada.")
EndIf
ReturnResultado esperado
Ejecuta la personalización solo cuando existe y respeta el retorno lógico.
- Combine com ExistBlock() quando o ponto de entrada for opcional.
- Leia a documentação do ponto de entrada para saber parâmetros, momento de execução e retorno esperado.
- Em validações, trate retorno lógico de forma explícita.
- Chamar ExecBlock() sem conhecer o contrato do ponto de entrada pode produzir erro ou comportamento inesperado.
- Não use como atalho genérico para acoplar rotinas sem documentação.
Comentarios
Todavía no hay comentarios aprobados.
Inicia sesión con Google o Microsoft para comentar.