Installer.LastErrorRecord method

The LastErrorRecord method of the Installer object returns a Record object that contains error parameters for the most recent error from the function that produced the error record.

Syntax

Installer.LastErrorRecord()

Parameters

This method has no parameters.

Return value

This method does not return a value.

Remarks

The Record object is reset after the execution of this function of any function that generates an error record.

Only the following designated functions generate an error record:

• OpenDatabase method (Installer Object)
• Commit
• OpenView
• Import
• Export
• Merge
• GenerateTransform
• ApplyTransform
• Execute
• Modify
• SetStream
• SummaryInformation
• SourcePath
• TargetPath
• ComponentCurrentState
• ComponentRequestState
• FeatureCurrentState
• FeatureRequestState
• FeatureCost
• FeatureValidStates
• SetInstallLevel

The following sample in VBScript uses a call to OpenDatabase to show how to obtain extended error information from one of the methods or properties that support the LastErrorRecord method. The sample constructs an error message when the OpenDatabase method fails. The Err object is used to determine whether an error was encountered.

Const msiOpenDatabaseModeReadOnly     = 0

On Error Resume Next ' defer error handling

Dim installer
Set installer = CreateObject("WindowsInstaller.Installer")

' attempt to open the non-existent MSI database
Dim database
Set database = installer.OpenDatabase("c:\nonexistent.msi", msiOpenDatabaseModeReadOnly)

' test for error
If Err.Number <> 0 Then
    Dim message, errorRec
    message = Err.Source & " " & Hex(Err.Number) & ": " & Err.Description
    If Not installer Is Nothing Then
        ' try to obtain extended error info
        Set errorRec = installer.LastErrorRecord
        If Not errorRec Is Nothing Then message = message & vbNewLine & errorRec.FormatText
    End If

    MsgBox message

    ' PLACE ADDITIONAL SCRIPTING CODE HERE TO LOG AND/OR DISPLAY THE MESSAGE AND
    ' DETERMINE WHETHER TO CONTINUE PROCESSING ANYTHING ELSE
End If

Requirements

Requirement	Value
Version	Windows Installer 5.0 on Windows Server 2012, Windows 8, Windows Server 2008 R2 or Windows 7. Windows Installer 4.0 or Windows Installer 4.5 on Windows Server 2008 or Windows Vista. Windows Installer on Windows Server 2003 or Windows XP
DLL	Msi.dll
IID	IID_IInstaller is defined as 000C1090-0000-0000-C000-000000000046