次の方法で共有


カスタム動作でのエラー処理

Windows インストーラーは、配置での大部分のエラー処理を自動的に管理します。ただし、カスタム動作のエラーによって、インストーラーの実行に失敗することがあります。 すべてのカスタム動作はコードを含んでいます。ほかのコードと同様に、カスタム動作でもエラー処理はプロセスの重要な部分です。 たとえば、カスタム動作にファイルを開くコードが含まれており、そのファイルがない場合、エラー処理によって Windows インストーラーにエラーを報告し、インストールをロールバックする必要があります。

注意

JScript .NET または VBScript によって作成されたカスタム動作では、エラーが Windows インストーラーに戻らず、インストールをロールバックできません。ユーザーにエラー ダイアログを表示することはできます。 インストールに不可欠なカスタム動作を作成する場合は、エラーを Windows インストーラーに渡すために、Visual Basic、Visual C#、または Visual C++ でコードを作成してください。

エラーのトラップ

カスタム動作でエラーを処理するには、エラーをトラップして Windows インストーラーにエラー情報を渡すコードを追加する必要があります。 Visual Basic、Visual C#、Visual C++、JScript、および 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;
}

参照

その他の技術情報

配置でのカスタム動作の管理