Método IDataModelScript2::InvokeMain (dbgmodel.h)
Se o script tiver uma "função principal" que se destina a ser executada a partir de uma invocação de interface do usuário, ele indicará isso por meio de um retorno verdadeiro do método IsInvocable. Em seguida, a interface do usuário pode chamar o método InvokeMain para realmente "invocar" o script. Observe que isso é diferente de Executar que executa todo o código raiz e conecta o script ao namespace do host subjacente.
Esse método pode falhar com E_NOTIMPL se o script não contiver uma "função principal" ou o provedor não definir tal.
Observe que um aplicativo que hospeda o modelo de dados pode carregar e executar um script uma vez, mas chamar o método InvokeMain de um número arbitrário de vezes sem uma chamada Executar intervindo. Espera-se que isso preserve o "contexto de script", mantenha o script carregado e chame apenas um método dentro do script várias vezes.
Se houver erros ou outros eventos que ocorram durante a execução do script, tais (e sua localização dentro do script) poderão ser passados pelo canal de comunicação entre o IDataModelScript2 e o inpassado IDataModelScriptClient.
Sintaxe
HRESULT InvokeMain(
IDataModelScriptClient *client
);
Parâmetros
client
Uma interface para o cliente que está solicitando que a função principal seja chamada. Se houver erros ou outros eventos que ocorram durante a execução da função principal, o script poderá passar essas informações e sua localização dentro do script de volta para o cliente por meio de chamadas de método nessa interface.
Valor de retorno
Esse método retorna HRESULT que indica êxito ou falha.
Requisitos
Requisito | Valor |
---|---|
cabeçalho | dbgmodel.h |