Deployment Tools Foundation
GetErrorRecord Method
Deployment Tools Foundation Namespaces ► Microsoft.Deployment.WindowsInstaller ► InstallerException ► GetErrorRecord()()()
Gets extended information about the error, or null if no further information
is available.
Declaration Syntax Return ValueA Record object. Field 1 of the Record contains the installer
message code. Other fields contain data specific to the particular error.
RemarksIf the record is passed to Message(InstallMessage, Record), it is formatted by looking up the string in the current database. If there is no installation session, the formatted error message may be obtained by a query on the Error table using the error code, followed by a call to ToString()()(). Alternatively, the standard MSI message can by retrieved by calling the GetErrorMessage(Record, CultureInfo) method.
The following methods and properties may report extended error data:
- Database (constructor)
- Database.ApplyTransform(String, TransformErrors)
- Database.Commit()()()
- Database.Execute(String, array<Object>[]()[])
- Database.ExecuteQuery(String, array<Object>[]()[])
- Database.ExecuteIntegerQuery(String, array<Object>[]()[])
- Database.ExecuteStringQuery(String, array<Object>[]()[])
- Database.Export(String, String)
- Database.ExportAll(String)
- Database.GenerateTransform(Database, String)
- Database.Import(String)
- Database.ImportAll(String)
- Database.Merge(Database, String)
- Database.OpenView(String, array<Object>[]()[])
- Database.SummaryInfo
- Database.ViewTransform(String)
- View.Assign(Record)
- View.Delete(Record)
- View.Execute(Record)
- View.Insert(Record)
- View.InsertTemporary(Record)
- View.Merge(Record)
- View.Modify(ViewModifyMode, Record)
- View.Refresh(Record)
- View.Replace(Record)
- View.Seek(Record)
- View.Update(Record)
- View.Validate(Record)
- View.ValidateFields(Record)
- View.ValidateDelete(Record)
- View.ValidateNew(Record)
- SummaryInfo (constructor)
- Record.SetStream(Int32, String)
- Session.SetInstallLevel(Int32)
- Session.GetSourcePath(String)
- Session.GetTargetPath(String)
- Session.SetTargetPath(String, String)
- ComponentInfo.CurrentState
- FeatureInfo.CurrentState
- FeatureInfo.ValidStates
- FeatureInfo.GetCost(Boolean, Boolean, InstallState)
The Record object should be Close()()()d after use. It is best that the handle be closed manually as soon as it is no longer needed, as leaving lots of unused handles open can degrade performance.
Win32 MSI API: MsiGetLastErrorRecord