Partilhar via

Valores de retorno de ações personalizadas de JScript e VBScript

Ações personalizadas escritas em JScript ou Visual Basic, Scripting Edition (VBScript) podem chamar uma função opcional. Essas funções devem retornar um dos valores mostrados na tabela a seguir.

Valor de retorno Valor Descrição
msiDoActionStatusNoAction 0 Ação não executada.
msiDoActionStatusSuccess IDOK = 1 Ação concluída com êxito.
msiDoActionStatusUserExit IDCANCEL = 2 Rescisão prematura por parte do utilizador.
msiDoActionStatusFailure IDABORT = 3 Erro irrecuperável. Retornado se houver um erro durante a análise ou execução do JScript ou VBScript.
msiDoActionStatusSuspend IDRETRY = 4 Sequência suspensa a retomar mais tarde.
msiDoActionStatusFinished IDIGNORE = 5 Ignore as ações restantes. Não é um erro.

 

Observe que o Windows Installer traduz os valores de retorno de todas as ações quando grava o valor de retorno no arquivo de log. Por exemplo, se o valor de retorno da ação aparecer como 1 (um) no arquivo de log, isso significa que a ação retornou msiDoActionStatusSuccess. Para obter mais informações sobre essa tradução, consulte Log of Action Return Values.

Para retornar um valor diferente de êxito de uma ação personalizada de script, você deve usar um destino de função para a ação personalizada. A função de destino é especificada na coluna Destino da tabela CustomAction.

O exemplo de script a seguir mostra como retornar sucesso ou falha de uma ação personalizada do VBScript.

Function MyVBScriptCA()

    If Session.Property("CustomErrorStatus") <> "0" Then
        'return error
        MyVBScriptCA = 3
        Exit Function
    End If

    ' return success
    MyVBScriptCA = 1
    Exit Function

End Function

Se esse VBScript fosse incorporado no da tabela Binary do pacote de instalação como MyCA.vbs, a entrada CustomAction Table para o script seria a seguinte:

Ação Tipo Fonte Público-alvo
MyCustomAction 6 MyCA.vbs MyVBScriptCA

 

 

 

  • Last updated on