Erro Handling in Custom Actions

O Windows Installer gerencia automaticamente a maioria erro tratamento na implantação; Entretanto, erro s em ações personalizadas podem causar um instalador falhe.Todas sistema autônomo ações personalizadas contêm código; sistema autônomo com qualquer código, tratamento de erro é 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 identificador de erro é necessário informar o erro voltar ao Windows Installer para que a instalação pode ser revertida.

Observação:
Para ações personalizadas que são escritas usando JScript ou VBScript, o erro não será retornado ao 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.

Interceptação de erro

Manipular um erro em uma ação personalizada, você precisará adicionar código para interceptar o erro e passar as informações de volta para o Windows Installer.Os exemplos a seguir mostram como tratar um erro em Visual Basic, Visual C#Código o 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

Gerenciamento de ações personalizadas no implantação