Tratamento de erros em ações Personalizar

Windows Installer gerencia automaticamente a maioria dos tratamento de erros em implantação; No entanto, os erros em ações personalizadas podem causar um instalador falha. Todas as ações personalizadas contêm código; como com qualquer código, o tratamento de erros é uma parte essencial do processo. Por exemplo, se uma ação personalizada inclui código que abre um arquivo e o arquivo estiver ausente, um manipulador de erro é necessário informar o erro de volta para o Windows Installer para que a instalação pode ser revertida.

ObservaçãoObservação

Para ações personalizadas que são escritas usando JScript ou VBScript, o erro não será retornado para o Windows Installer e a instalação não pode ser revertida; uma caixa de diálogo de erro pode ser exibida para o usuário. Ações personalizadas que são essenciais para uma instalação devem ser escritas de Visual Basic, Visual C#, ou Visual C++ para passar o erro para o Windows Installer.

Interceptar o erro.

Para manipular um erro em uma ação personalizada, você precisará adicionar o código para interceptar o erro e passar as informações de volta para o Windows Installer. Os exemplos a seguir mostram como manipular um erro em Visual Basic, Visual C#, código do Visual C++, JScript e VBScript:

' Uses System.IO and System.Configuration.Install
Dim Info As New FileInfo("MyFile.txt")
If Not Info.Exists Then
    Throw New InstallException("File does not exist")
End If
// Uses System.IO and System.Configuration.Install
FileInfo Info = new FileInfo("MyFile.txt");
if (Info.Exists == false)
   throw new InstallException("File does not exist");
'VBScript
msiMessageTypeError = &H01000000 
Set fso = CreateObject("Scripting.FileSystemObject")
If Not fso.FileExists("c:\MyFile.txt") Then
   Set record = Session.Installer.CreateRecord(0)
   record.StringData(0) = "File not found."
   Session.Message msiMessageTypeError, record
End If
var msiMessageTypeError = 0x01000000;
var fso = new ActiveXObject("Scripting.FileSystemObject");
if (!fso.FileExists("c:\\MyFile.txt"))
{
   var record = Session.Installer.CreateRecord(0);
   record.StringData(0) = "File not found.";
   Session.Message(msiMessageTypeError, record);
}
#pragma comment(lib, "msi.lib")

#include <windows.h>
#include <msiquery.h>

BOOL APIENTRY DllMain(HINSTANCE hInstance, DWORD fdwREason, LPVOID lpReserved)
{
   return TRUE;
}

extern "C" __declspec(dllexport) __stdcall Install(MSIHANDLE hInstall)
{
   if (GetFileAttributes(TEXT("c:\\MyFile.txt")) == -1)
   {
      PMSIHANDLE hRecord = MsiCreateRecord(0);
      MsiRecordSetString(hRecord, 0, TEXT("File does not exist."));
      MsiProcessMessage(hInstall, INSTALLMESSAGE(INSTALLMESSAGE_ERROR + MB_OK), hRecord);
      return ERROR_INSTALL_USEREXIT;
   }
   
   return ERROR_SUCCESS;
}

Consulte também

Outros recursos

Personalizar Gerenciamento de ações na implantação