カスタム動作でのエラー処理
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;
}