Add new caching BA events.

#3640
author: Sean Hall <r.sean.hall@gmail.com> 2021-04-19 17:35:44 -0500
committer: Sean Hall <r.sean.hall@gmail.com> 2021-04-19 23:23:39 -0500
commit: 11fe2c881d182f9caff28bd9ff08c2e4fe513989 (patch)
tree: a2f1769b78e9b1eb4708678fe6b5374eec209c6a
parent: 62b32cd6f21292c73dae8d5cfcd3a1cb13a1fd7d (diff)
download: wix-11fe2c881d182f9caff28bd9ff08c2e4fe513989.tar.gz
wix-11fe2c881d182f9caff28bd9ff08c2e4fe513989.tar.bz2
wix-11fe2c881d182f9caff28bd9ff08c2e4fe513989.zip
9 files changed, 943 insertions, 378 deletions
diff --git a/src/WixToolset.Mba.Core/BootstrapperApplication.cs b/src/WixToolset.Mba.Core/BootstrapperApplication.cs
index 79cbfa86..0a8f3af8 100644
--- a/src/WixToolset.Mba.Core/BootstrapperApplication.cs
+++ b/src/WixToolset.Mba.Core/BootstrapperApplication.cs
@@ -155,6 +155,9 @@ namespace WixToolset.Mba.Core
        public event EventHandler<CacheVerifyBeginEventArgs> CacheVerifyBegin;
        /// <inheritdoc/>
+        public event EventHandler<CacheVerifyProgressEventArgs> CacheVerifyProgress;
+        /// <inheritdoc/>
        public event EventHandler<CacheVerifyCompleteEventArgs> CacheVerifyComplete;
        /// <inheritdoc/>
@@ -229,6 +232,24 @@ namespace WixToolset.Mba.Core
        /// <inheritdoc/>
        public event EventHandler<PlanForwardCompatibleBundleEventArgs> PlanForwardCompatibleBundle;
+        /// <inheritdoc/>
+        public event EventHandler<CacheContainerOrPayloadVerifyBeginEventArgs> CacheContainerOrPayloadVerifyBegin;
+        /// <inheritdoc/>
+        public event EventHandler<CacheContainerOrPayloadVerifyProgressEventArgs> CacheContainerOrPayloadVerifyProgress;
+        /// <inheritdoc/>
+        public event EventHandler<CacheContainerOrPayloadVerifyCompleteEventArgs> CacheContainerOrPayloadVerifyComplete;
+        /// <inheritdoc/>
+        public event EventHandler<CachePayloadExtractBeginEventArgs> CachePayloadExtractBegin;
+        /// <inheritdoc/>
+        public event EventHandler<CachePayloadExtractProgressEventArgs> CachePayloadExtractProgress;
+        /// <inheritdoc/>
+        public event EventHandler<CachePayloadExtractCompleteEventArgs> CachePayloadExtractComplete;
        /// <summary>
        /// Entry point that is called when the bootstrapper application is ready to run.
        /// </summary>
@@ -775,6 +796,19 @@ namespace WixToolset.Mba.Core
        }
        /// <summary>
+        /// Called by the engine, raises the <see cref="CacheVerifyProgress"/> event.
+        /// </summary>
+        /// <param name="args"></param>
+        protected virtual void OnCacheVerifyProgress(CacheVerifyProgressEventArgs args)
+        {
+            EventHandler<CacheVerifyProgressEventArgs> handler = this.CacheVerifyProgress;
+            if (null != handler)
+            {
+                handler(this, args);
+            }
+        }
+        /// <summary>
        /// Called by the engine, raises the <see cref="CacheVerifyComplete"/> event.
        /// </summary>
        /// <param name="args"></param>
@@ -1098,8 +1132,99 @@ namespace WixToolset.Mba.Core
            }
        }
+        /// <summary>
+        /// Called by the engine, raises the <see cref="CacheContainerOrPayloadVerifyBegin"/> event.
+        /// </summary>
+        /// <param name="args"></param>
+        protected virtual void OnCacheContainerOrPayloadVerifyBegin(CacheContainerOrPayloadVerifyBeginEventArgs args)
+        {
+            EventHandler<CacheContainerOrPayloadVerifyBeginEventArgs> handler = this.CacheContainerOrPayloadVerifyBegin;
+            if (null != handler)
+            {
+                handler(this, args);
+            }
+        }
+        /// <summary>
+        /// Called by the engine, raises the <see cref="CacheContainerOrPayloadVerifyProgress"/> event.
+        /// </summary>
+        /// <param name="args"></param>
+        protected virtual void OnCacheContainerOrPayloadVerifyProgress(CacheContainerOrPayloadVerifyProgressEventArgs args)
+        {
+            EventHandler<CacheContainerOrPayloadVerifyProgressEventArgs> handler = this.CacheContainerOrPayloadVerifyProgress;
+            if (null != handler)
+            {
+                handler(this, args);
+            }
+        }
+        /// <summary>
+        /// Called by the engine, raises the <see cref="CacheContainerOrPayloadVerifyComplete"/> event.
+        /// </summary>
+        /// <param name="args"></param>
+        protected virtual void OnCacheContainerOrPayloadVerifyComplete(CacheContainerOrPayloadVerifyCompleteEventArgs args)
+        {
+            EventHandler<CacheContainerOrPayloadVerifyCompleteEventArgs> handler = this.CacheContainerOrPayloadVerifyComplete;
+            if (null != handler)
+            {
+                handler(this, args);
+            }
+        }
+        /// <summary>
+        /// Called by the engine, raises the <see cref="CachePayloadExtractBegin"/> event.
+        /// </summary>
+        /// <param name="args"></param>
+        protected virtual void OnCachePayloadExtractBegin(CachePayloadExtractBeginEventArgs args)
+        {
+            EventHandler<CachePayloadExtractBeginEventArgs> handler = this.CachePayloadExtractBegin;
+            if (null != handler)
+            {
+                handler(this, args);
+            }
+        }
+        /// <summary>
+        /// Called by the engine, raises the <see cref="CachePayloadExtractProgress"/> event.
+        /// </summary>
+        /// <param name="args"></param>
+        protected virtual void OnCachePayloadExtractProgress(CachePayloadExtractProgressEventArgs args)
+        {
+            EventHandler<CachePayloadExtractProgressEventArgs> handler = this.CachePayloadExtractProgress;
+            if (null != handler)
+            {
+                handler(this, args);
+            }
+        }
+        /// <summary>
+        /// Called by the engine, raises the <see cref="CachePayloadExtractComplete"/> event.
+        /// </summary>
+        /// <param name="args"></param>
+        protected virtual void OnCachePayloadExtractComplete(CachePayloadExtractCompleteEventArgs args)
+        {
+            EventHandler<CachePayloadExtractCompleteEventArgs> handler = this.CachePayloadExtractComplete;
+            if (null != handler)
+            {
+                handler(this, args);
+            }
+        }
        #region IBootstrapperApplication Members
+        int IBootstrapperApplication.BAProc(int message, IntPtr pvArgs, IntPtr pvResults, IntPtr pvContext)
+        {
+            switch (message)
+            {
+                default:
+                    return NativeMethods.E_NOTIMPL;
+            }
+        }
+        void IBootstrapperApplication.BAProcFallback(int message, IntPtr pvArgs, IntPtr pvResults, ref int phr, IntPtr pvContext)
+        {
+        }
        int IBootstrapperApplication.OnStartup()
        {
            StartupEventArgs args = new StartupEventArgs();
@@ -1439,18 +1564,27 @@ namespace WixToolset.Mba.Core
            return args.HResult;
        }
-        int IBootstrapperApplication.OnCacheVerifyBegin(string wzPackageId, string wzPayloadId, ref bool fCancel)
+        int IBootstrapperApplication.OnCacheVerifyBegin(string wzPackageOrContainerId, string wzPayloadId, ref bool fCancel)
        {
-            CacheVerifyBeginEventArgs args = new CacheVerifyBeginEventArgs(wzPackageId, wzPayloadId, fCancel);
+            CacheVerifyBeginEventArgs args = new CacheVerifyBeginEventArgs(wzPackageOrContainerId, wzPayloadId, fCancel);
            this.OnCacheVerifyBegin(args);
            fCancel = args.Cancel;
            return args.HResult;
        }
-        int IBootstrapperApplication.OnCacheVerifyComplete(string wzPackageId, string wzPayloadId, int hrStatus, BOOTSTRAPPER_CACHEVERIFYCOMPLETE_ACTION recommendation, ref BOOTSTRAPPER_CACHEVERIFYCOMPLETE_ACTION action)
+        int IBootstrapperApplication.OnCacheVerifyProgress(string wzPackageOrContainerId, string wzPayloadId, long dw64Progress, long dw64Total, int dwOverallPercentage, CacheVerifyStep verifyStep, ref bool fCancel)
+        {
+            CacheVerifyProgressEventArgs args = new CacheVerifyProgressEventArgs(wzPackageOrContainerId, wzPayloadId, dw64Progress, dw64Total, dwOverallPercentage, verifyStep, fCancel);
+            this.OnCacheVerifyProgress(args);
+            fCancel = args.Cancel;
+            return args.HResult;
+        }
+        int IBootstrapperApplication.OnCacheVerifyComplete(string wzPackageOrContainerId, string wzPayloadId, int hrStatus, BOOTSTRAPPER_CACHEVERIFYCOMPLETE_ACTION recommendation, ref BOOTSTRAPPER_CACHEVERIFYCOMPLETE_ACTION action)
        {
-            CacheVerifyCompleteEventArgs args = new CacheVerifyCompleteEventArgs(wzPackageId, wzPayloadId, hrStatus, recommendation, action);
+            CacheVerifyCompleteEventArgs args = new CacheVerifyCompleteEventArgs(wzPackageOrContainerId, wzPayloadId, hrStatus, recommendation, action);
            this.OnCacheVerifyComplete(args);
            action = args.Action;
@@ -1682,17 +1816,56 @@ namespace WixToolset.Mba.Core
            return args.HResult;
        }
-        int IBootstrapperApplication.BAProc(int message, IntPtr pvArgs, IntPtr pvResults, IntPtr pvContext)
+        int IBootstrapperApplication.OnCacheContainerOrPayloadVerifyBegin(string wzPackageOrContainerId, string wzPayloadId, ref bool fCancel)
        {
-            switch (message)
+            CacheContainerOrPayloadVerifyBeginEventArgs args = new CacheContainerOrPayloadVerifyBeginEventArgs(wzPackageOrContainerId, wzPayloadId, fCancel);
-            {
+            this.OnCacheContainerOrPayloadVerifyBegin(args);
-                default:
-                    return NativeMethods.E_NOTIMPL;
+            fCancel = args.Cancel;
-            }
+            return args.HResult;
        }
-        void IBootstrapperApplication.BAProcFallback(int message, IntPtr pvArgs, IntPtr pvResults, ref int phr, IntPtr pvContext)
+        int IBootstrapperApplication.OnCacheContainerOrPayloadVerifyProgress(string wzPackageOrContainerId, string wzPayloadId, long dw64Progress, long dw64Total, int dwOverallPercentage, ref bool fCancel)
+        {
+            CacheContainerOrPayloadVerifyProgressEventArgs args = new CacheContainerOrPayloadVerifyProgressEventArgs(wzPackageOrContainerId, wzPayloadId, dw64Progress, dw64Total, dwOverallPercentage, fCancel);
+            this.OnCacheContainerOrPayloadVerifyProgress(args);
+            fCancel = args.Cancel;
+            return args.HResult;
+        }
+        int IBootstrapperApplication.OnCacheContainerOrPayloadVerifyComplete(string wzPackageOrContainerId, string wzPayloadId, int hrStatus)
+        {
+            CacheContainerOrPayloadVerifyCompleteEventArgs args = new CacheContainerOrPayloadVerifyCompleteEventArgs(wzPackageOrContainerId, wzPayloadId, hrStatus);
+            this.OnCacheContainerOrPayloadVerifyComplete(args);
+            return args.HResult;
+        }
+        int IBootstrapperApplication.OnCachePayloadExtractBegin(string wzContainerId, string wzPayloadId, ref bool fCancel)
+        {
+            CachePayloadExtractBeginEventArgs args = new CachePayloadExtractBeginEventArgs(wzContainerId, wzPayloadId, fCancel);
+            this.OnCachePayloadExtractBegin(args);
+            fCancel = args.Cancel;
+            return args.HResult;
+        }
+        int IBootstrapperApplication.OnCachePayloadExtractProgress(string wzContainerId, string wzPayloadId, long dw64Progress, long dw64Total, int dwOverallPercentage, ref bool fCancel)
        {
+            CachePayloadExtractProgressEventArgs args = new CachePayloadExtractProgressEventArgs(wzContainerId, wzPayloadId, dw64Progress, dw64Total, dwOverallPercentage, fCancel);
+            this.OnCachePayloadExtractProgress(args);
+            fCancel = args.Cancel;
+            return args.HResult;
+        }
+        int IBootstrapperApplication.OnCachePayloadExtractComplete(string wzContainerId, string wzPayloadId, int hrStatus)
+        {
+            CachePayloadExtractCompleteEventArgs args = new CachePayloadExtractCompleteEventArgs(wzContainerId, wzPayloadId, hrStatus);
+            this.OnCachePayloadExtractComplete(args);
+            return args.HResult;
        }
        #endregion
diff --git a/src/WixToolset.Mba.Core/EventArgs.cs b/src/WixToolset.Mba.Core/EventArgs.cs
index ee89b583..e64f6d2c 100644
--- a/src/WixToolset.Mba.Core/EventArgs.cs
+++ b/src/WixToolset.Mba.Core/EventArgs.cs
@@ -51,11 +51,7 @@ namespace WixToolset.Mba.Core
    [Serializable]
    public abstract class ResultEventArgs : HResultEventArgs
    {
-        /// <summary>
+        /// <summary />
-        /// Creates a new instance of the <see cref="ResultEventArgs"/> class.
-        /// </summary>
-        /// <param name="recommendation">Recommended result from engine.</param>
-        /// <param name="result">The result to return to the engine.</param>
        public ResultEventArgs(Result recommendation, Result result)
        {
            this.Recommendation = recommendation;
@@ -99,11 +95,7 @@ namespace WixToolset.Mba.Core
    /// </summary>
    public abstract class ActionEventArgs<T> : StatusEventArgs
    {
-        /// <summary>
+        /// <summary />
-        /// </summary>
-        /// <param name="hrStatus">The return code of the operation.</param>
-        /// <param name="recommendation">Recommended action from engine.</param>
-        /// <param name="action">The action to perform.</param>
        public ActionEventArgs(int hrStatus, T recommendation, T action)
            : base(hrStatus)
        {
@@ -148,6 +140,49 @@ namespace WixToolset.Mba.Core
    }
    /// <summary>
+    /// Base class for cache progress events.
+    /// </summary>
+    [Serializable]
+    public abstract class CacheProgressBaseEventArgs : CancellableHResultEventArgs
+    {
+        /// <summary />
+        public CacheProgressBaseEventArgs(string packageOrContainerId, string payloadId, long progress, long total, int overallPercentage, bool cancelRecommendation)
+            : base(cancelRecommendation)
+        {
+            this.PackageOrContainerId = packageOrContainerId;
+            this.PayloadId = payloadId;
+            this.Progress = progress;
+            this.Total = total;
+            this.OverallPercentage = overallPercentage;
+        }
+        /// <summary>
+        /// Gets the identifier of the container or package.
+        /// </summary>
+        public string PackageOrContainerId { get; private set; }
+        /// <summary>
+        /// Gets the identifier of the payload.
+        /// </summary>
+        public string PayloadId { get; private set; }
+        /// <summary>
+        /// Gets the number of bytes cached thus far.
+        /// </summary>
+        public long Progress { get; private set; }
+        /// <summary>
+        /// Gets the total bytes to cache.
+        /// </summary>
+        public long Total { get; private set; }
+        /// <summary>
+        /// Gets the overall percentage of progress of caching.
+        /// </summary>
+        public int OverallPercentage { get; private set; }
+    }
+    /// <summary>
    /// Additional arguments used when startup has begun.
    /// </summary>
    [Serializable]
@@ -182,25 +217,12 @@ namespace WixToolset.Mba.Core
    }
    /// <summary>
-    /// Additional arguments used when the system is shutting down or the user is logging off.
+    /// Event arguments for <see cref="IDefaultBootstrapperApplication.SystemShutdown"/>
    /// </summary>
-    /// <remarks>
-    /// <para>To prevent shutting down or logging off, set <see cref="CancellableHResultEventArgs.Cancel"/> to
-    /// true; otherwise, set it to false.</para>
-    /// <para>By default setup will prevent shutting down or logging off between
-    /// <see cref="IDefaultBootstrapperApplication.ApplyBegin"/> and <see cref="IDefaultBootstrapperApplication.ApplyComplete"/>.</para>
-    /// <para>If <see cref="SystemShutdownEventArgs.Reasons"/> contains <see cref="EndSessionReasons.Critical"/>
-    /// the bootstrapper cannot prevent the shutdown and only has a few seconds to save state or perform any other
-    /// critical operations before being closed by the operating system.</para>
-    /// </remarks>
    [Serializable]
    public class SystemShutdownEventArgs : CancellableHResultEventArgs
    {
-        /// <summary>
+        /// <summary />
-        /// Creates a new instance of the <see cref="SystemShutdownEventArgs"/> class.
-        /// </summary>
-        /// <param name="reasons">The reason the application is requested to close or being closed.</param>
-        /// <param name="cancelRecommendation">The recommendation from the engine.</param>
        public SystemShutdownEventArgs(EndSessionReasons reasons, bool cancelRecommendation)
            : base(cancelRecommendation)
        {
@@ -301,17 +323,12 @@ namespace WixToolset.Mba.Core
    }
    /// <summary>
-    /// Additional arguments used when the detection for an update has begun.
+    /// Event arguments for <see cref="IDefaultBootstrapperApplication.DetectUpdateBegin"/>
    /// </summary>
    [Serializable]
    public class DetectUpdateBeginEventArgs : CancellableHResultEventArgs
    {
-        /// <summary>
+        /// <summary />
-        /// Creates a new instance of the <see cref="DetectUpdateBeginEventArgs"/> class.
-        /// </summary>
-        /// <param name="updateLocation">The location to check for an updated bundle.</param>
-        /// <param name="cancelRecommendation">The cancel recommendation from the engine.</param>
-        /// <param name="skipRecommendation">The skip recommendation from the engine.</param>
        public DetectUpdateBeginEventArgs(string updateLocation, bool cancelRecommendation, bool skipRecommendation)
            : base(cancelRecommendation)
        {
@@ -331,23 +348,12 @@ namespace WixToolset.Mba.Core
    }
    /// <summary>
-    /// Additional arguments used when the detection for an update has begun.
+    /// Event arguments for <see cref="IDefaultBootstrapperApplication.DetectUpdate"/>
    /// </summary>
    [Serializable]
    public class DetectUpdateEventArgs : CancellableHResultEventArgs
    {
-        /// <summary>
+        /// <summary />
-        /// Creates a new instance of the <see cref="DetectUpdateBeginEventArgs"/> class.
-        /// </summary>
-        /// <param name="updateLocation">The location to check for an updated bundle.</param>
-        /// <param name="size">The expected size of the updated bundle.</param>
-        /// <param name="version">The expected version of the updated bundle.</param>
-        /// <param name="title">The title of the updated bundle.</param>
-        /// <param name="summary">The summary of the updated bundle.</param>
-        /// <param name="contentType">The content type of the content of the updated bundle.</param>
-        /// <param name="content">The content of the updated bundle.</param>
-        /// <param name="cancelRecommendation">The recommendation from the engine.</param>
-        /// <param name="stopRecommendation">The recommendation from the engine.</param>
        public DetectUpdateEventArgs(string updateLocation, long size, string version, string title, string summary, string contentType, string content, bool cancelRecommendation, bool stopRecommendation)
            : base(cancelRecommendation)
        {
@@ -403,16 +409,12 @@ namespace WixToolset.Mba.Core
    }
    /// <summary>
-    /// Additional arguments used when the detection for an update has completed.
+    /// Event arguments for <see cref="IDefaultBootstrapperApplication.DetectUpdateComplete"/>
    /// </summary>
    [Serializable]
    public class DetectUpdateCompleteEventArgs : StatusEventArgs
    {
-        /// <summary>
+        /// <summary />
-        /// Creates a new instance of the <see cref="DetectUpdateCompleteEventArgs"/> class.
-        /// </summary>
-        /// <param name="hrStatus">The return code of the operation.</param>
-        /// <param name="ignoreRecommendation">The recommendation from the engine.</param>
        public DetectUpdateCompleteEventArgs(int hrStatus, bool ignoreRecommendation)
            : base(hrStatus)
        {
@@ -481,16 +483,12 @@ namespace WixToolset.Mba.Core
    }
    /// <summary>
-    /// Additional arguments used when the detection for a specific package has begun.
+    /// Event arguments for <see cref="IDefaultBootstrapperApplication.DetectPackageBegin"/>
    /// </summary>
    [Serializable]
    public class DetectPackageBeginEventArgs : CancellableHResultEventArgs
    {
-        /// <summary>
+        /// <summary />
-        /// Creates a new instance of the <see cref="DetectPackageBeginEventArgs"/> class.
-        /// </summary>
-        /// <param name="packageId">The identity of the package to detect.</param>
-        /// <param name="cancelRecommendation">The recommendation from the engine.</param>
        public DetectPackageBeginEventArgs(string packageId, bool cancelRecommendation)
            : base(cancelRecommendation)
        {
@@ -504,21 +502,12 @@ namespace WixToolset.Mba.Core
    }
    /// <summary>
-    /// Additional arguments used when a related MSI package has been detected for a package.
+    /// Event arguments for <see cref="IDefaultBootstrapperApplication.DetectRelatedMsiPackage"/>
    /// </summary>
    [Serializable]
    public class DetectRelatedMsiPackageEventArgs : CancellableHResultEventArgs
    {
-        /// <summary>
+        /// <summary />
-        /// Creates a new instance of the <see cref="DetectRelatedMsiPackageEventArgs"/> class.
-        /// </summary>
-        /// <param name="packageId">The identity of the package detecting.</param>
-        /// <param name="upgradeCode">The upgrade code of the related package detected.</param>
-        /// <param name="productCode">The identity of the related package detected.</param>
-        /// <param name="perMachine">Whether the detected package is per machine.</param>
-        /// <param name="version">The version of the related package detected.</param>
-        /// <param name="operation">The operation that will be taken on the detected package.</param>
-        /// <param name="cancelRecommendation">The recommendation from the engine.</param>
        public DetectRelatedMsiPackageEventArgs(string packageId, string upgradeCode, string productCode, bool perMachine, string version, RelatedOperation operation, bool cancelRecommendation)
            : base(cancelRecommendation)
        {
@@ -598,17 +587,11 @@ namespace WixToolset.Mba.Core
    }
    /// <summary>
-    /// Additional arguments used when a feature in an MSI package has been detected.
+    /// Event arguments for <see cref="IDefaultBootstrapperApplication.DetectMsiFeature"/>
    /// </summary>
    public class DetectMsiFeatureEventArgs : CancellableHResultEventArgs
    {
-        /// <summary>
+        /// <summary />
-        /// Creates a new instance of the <see cref="DetectMsiFeatureEventArgs"/> class.
-        /// </summary>
-        /// <param name="packageId">Detected package identifier.</param>
-        /// <param name="featureId">Detected feature identifier.</param>
-        /// <param name="state">Feature state detected.</param>
-        /// <param name="cancelRecommendation">The recommendation from the engine.</param>
        public DetectMsiFeatureEventArgs(string packageId, string featureId, FeatureState state, bool cancelRecommendation)
            : base(cancelRecommendation)
        {
@@ -687,16 +670,12 @@ namespace WixToolset.Mba.Core
    }
    /// <summary>
-    /// Additional arguments used when the engine has begun planning the installation.
+    /// Event arguments for <see cref="IDefaultBootstrapperApplication.PlanBegin"/>
    /// </summary>
    [Serializable]
    public class PlanBeginEventArgs : CancellableHResultEventArgs
    {
-        /// <summary>
+        /// <summary />
-        /// Creates a new instance of the <see cref="PlanBeginEventArgs"/> class.
-        /// </summary>
-        /// <param name="packageCount">The number of packages to plan for.</param>
-        /// <param name="cancelRecommendation">The recommendation from the engine.</param>
        public PlanBeginEventArgs(int packageCount, bool cancelRecommendation)
            : base(cancelRecommendation)
        {
@@ -710,18 +689,12 @@ namespace WixToolset.Mba.Core
    }
    /// <summary>
-    /// Additional arguments used when the engine has begun planning for a related bundle.
+    /// Event arguments for <see cref="IDefaultBootstrapperApplication.PlanRelatedBundle"/>
    /// </summary>
    [Serializable]
    public class PlanRelatedBundleEventArgs : CancellableHResultEventArgs
    {
-        /// <summary>
+        /// <summary />
-        /// Creates a new instance of the <see cref="PlanRelatedBundleEventArgs"/> class.
-        /// </summary>
-        /// <param name="bundleId">The identity of the bundle to plan for.</param>
-        /// <param name="recommendedState">The recommended requested state for the bundle.</param>
-        /// <param name="state">The requested state for the bundle.</param>
-        /// <param name="cancelRecommendation">The recommendation from the engine.</param>
        public PlanRelatedBundleEventArgs(string bundleId, RequestState recommendedState, RequestState state, bool cancelRecommendation)
            : base(cancelRecommendation)
        {
@@ -842,19 +815,12 @@ namespace WixToolset.Mba.Core
    }
    /// <summary>
-    /// Additional arguments used when engine is about to plan a feature in an MSI package.
+    /// Event arguments for <see cref="IDefaultBootstrapperApplication.PlanMsiFeature"/>
    /// </summary>
    [Serializable]
    public class PlanMsiFeatureEventArgs : CancellableHResultEventArgs
    {
-        /// <summary>
+        /// <summary />
-        /// Creates a new instance of the <see cref="PlanMsiFeatureEventArgs"/> class.
-        /// </summary>
-        /// <param name="packageId">Package identifier being planned.</param>
-        /// <param name="featureId">Feature identifier being planned.</param>
-        /// <param name="recommendedState">Recommended feature state being planned.</param>
-        /// <param name="state">Feature state being planned.</param>
-        /// <param name="cancelRecommendation">The recommendation from the engine.</param>
        public PlanMsiFeatureEventArgs(string packageId, string featureId, FeatureState recommendedState, FeatureState state, bool cancelRecommendation)
            : base(cancelRecommendation)
        {
@@ -886,21 +852,12 @@ namespace WixToolset.Mba.Core
    }
    /// <summary>
-    /// Additional arguments used when the engine is planning an MSI or MSP package.
+    /// Event arguments for <see cref="IDefaultBootstrapperApplication.PlanMsiPackage"/>
    /// </summary>
    [Serializable]
    public class PlanMsiPackageEventArgs : CancellableHResultEventArgs
    {
-        /// <summary>
+        /// <summary />
-        /// Creates a new instance of the <see cref="PlanMsiPackageEventArgs"/> class.
-        /// </summary>
-        /// <param name="packageId">The identity of the package planned for.</param>
-        /// <param name="shouldExecute">Whether the package is planned to execute or roll back.</param>
-        /// <param name="action">The action planned for the package.</param>
-        /// <param name="cancelRecommendation">The recommendation from the engine.</param>
-        /// <param name="actionMsiProperty">The requested MSI property to add.</param>
-        /// <param name="uiLevel">The requested internal UI level.</param>
-        /// <param name="disableExternalUiHandler">Whether Burn is requested to set up an external UI handler.</param>
        public PlanMsiPackageEventArgs(string packageId, bool shouldExecute, ActionState action, bool cancelRecommendation, BURN_MSI_PROPERTY actionMsiProperty, INSTALLUILEVEL uiLevel, bool disableExternalUiHandler)
            : base(cancelRecommendation)
        {
@@ -1080,16 +1037,12 @@ namespace WixToolset.Mba.Core
    }
    /// <summary>
-    /// Additional arguments used when the engine has begun installing the bundle.
+    /// Event arguments for <see cref="IDefaultBootstrapperApplication.ApplyBegin"/>
    /// </summary>
    [Serializable]
    public class ApplyBeginEventArgs : CancellableHResultEventArgs
    {
-        /// <summary>
+        /// <summary />
-        /// Creates a new instance of the <see cref="ApplyBeginEventArgs"/> class.
-        /// </summary>
-        /// <param name="phaseCount">The number of phases during apply.</param>
-        /// <param name="cancelRecommendation">The recommendation from the engine.</param>
        public ApplyBeginEventArgs(int phaseCount, bool cancelRecommendation)
            : base(cancelRecommendation)
        {
@@ -1104,15 +1057,12 @@ namespace WixToolset.Mba.Core
    }
    /// <summary>
-    /// Additional arguments used when the engine is about to start the elevated process.
+    /// Event arguments for <see cref="IDefaultBootstrapperApplication.ElevateBegin"/>
    /// </summary>
    [Serializable]
    public class ElevateBeginEventArgs : CancellableHResultEventArgs
    {
-        /// <summary>
+        /// <summary />
-        /// Creates a new instance of the <see cref="ElevateBeginEventArgs"/> class.
-        /// </summary>
-        /// <param name="cancelRecommendation">The recommendation from the engine.</param>
        public ElevateBeginEventArgs(bool cancelRecommendation)
            : base(cancelRecommendation)
        {
@@ -1136,17 +1086,12 @@ namespace WixToolset.Mba.Core
    }
    /// <summary>
-    /// Additional arguments used when the engine has changed progress for the bundle installation.
+    /// Event arguments for <see cref="IDefaultBootstrapperApplication.Progress"/>
    /// </summary>
    [Serializable]
    public class ProgressEventArgs : CancellableHResultEventArgs
    {
-        /// <summary>
+        /// <summary />
-        /// Creates an new instance of the <see cref="ProgressEventArgs"/> class.
-        /// </summary>
-        /// <param name="progressPercentage">The percentage from 0 to 100 completed for a package.</param>
-        /// <param name="overallPercentage">The percentage from 0 to 100 completed for the bundle.</param>
-        /// <param name="cancelRecommendation">The recommendation from the engine.</param>
        public ProgressEventArgs(int progressPercentage, int overallPercentage, bool cancelRecommendation)
            : base(cancelRecommendation)
        {
@@ -1166,22 +1111,12 @@ namespace WixToolset.Mba.Core
    }
    /// <summary>
-    /// Additional arguments used when the engine has encountered an error.
+    /// Event arguments for <see cref="IDefaultBootstrapperApplication.Error"/>
    /// </summary>
    [Serializable]
    public class ErrorEventArgs : ResultEventArgs
    {
-        /// <summary>
+        /// <summary />
-        /// Creates a new instance of the <see cref="ErrorEventArgs"/> class.
-        /// </summary>
-        /// <param name="errorType">The error type.</param>
-        /// <param name="packageId">The identity of the package that yielded the error.</param>
-        /// <param name="errorCode">The error code.</param>
-        /// <param name="errorMessage">The error message.</param>
-        /// <param name="dwUIHint">Recommended display flags for an error dialog.</param>
-        /// <param name="data">The exteded data for the error.</param>
-        /// <param name="recommendation">Recommended result from engine.</param>
-        /// <param name="result">The result to return to the engine.</param>
        public ErrorEventArgs(ErrorType errorType, string packageId, int errorCode, string errorMessage, int dwUIHint, string[] data, Result recommendation, Result result)
            : base(recommendation, result)
        {
@@ -1225,15 +1160,12 @@ namespace WixToolset.Mba.Core
    }
    /// <summary>
-    /// Additional arguments used when the engine has begun registering the location and visibility of the bundle.
+    /// Event arguments for <see cref="IDefaultBootstrapperApplication.RegisterBegin"/>
    /// </summary>
    [Serializable]
    public class RegisterBeginEventArgs : CancellableHResultEventArgs
    {
-        /// <summary>
+        /// <summary />
-        /// Creates a new instance of the <see cref="RegisterBeginEventArgs"/> class.
-        /// </summary>
-        /// <param name="cancelRecommendation">The recommendation from the engine.</param>
        public RegisterBeginEventArgs(bool cancelRecommendation)
            : base(cancelRecommendation)
        {
@@ -1301,15 +1233,12 @@ namespace WixToolset.Mba.Core
    }
    /// <summary>
-    /// Additional arguments used when the engine has begun caching the installation sources.
+    /// Event arguments for <see cref="IDefaultBootstrapperApplication.CacheBegin"/>
    /// </summary>
    [Serializable]
    public class CacheBeginEventArgs : CancellableHResultEventArgs
    {
-        /// <summary>
+        /// <summary />
-        /// Creates a new instance of the <see cref="CacheBeginEventArgs"/> class.
-        /// </summary>
-        /// <param name="cancelRecommendation">The recommendation from the engine.</param>
        public CacheBeginEventArgs(bool cancelRecommendation)
            : base(cancelRecommendation)
        {
@@ -1363,43 +1292,13 @@ namespace WixToolset.Mba.Core
    /// EventArgs for <see cref="IDefaultBootstrapperApplication.CacheAcquireProgress"/>.
    /// </summary>
    [Serializable]
-    public class CacheAcquireProgressEventArgs : CancellableHResultEventArgs
+    public class CacheAcquireProgressEventArgs : CacheProgressBaseEventArgs
    {
        /// <summary />
        public CacheAcquireProgressEventArgs(string packageOrContainerId, string payloadId, long progress, long total, int overallPercentage, bool cancelRecommendation)
-            : base(cancelRecommendation)
+            : base(packageOrContainerId, payloadId, progress, total, overallPercentage, cancelRecommendation)
        {
-            this.PackageOrContainerId = packageOrContainerId;
-            this.PayloadId = payloadId;
-            this.Progress = progress;
-            this.Total = total;
-            this.OverallPercentage = overallPercentage;
        }
-        /// <summary>
-        /// Gets the identifier of the container or package.
-        /// </summary>
-        public string PackageOrContainerId { get; private set; }
-        /// <summary>
-        /// Gets the identifier of the payload (if acquiring a payload).
-        /// </summary>
-        public string PayloadId { get; private set; }
-        /// <summary>
-        /// Gets the number of bytes cached thus far.
-        /// </summary>
-        public long Progress { get; private set; }
-        /// <summary>
-        /// Gets the total bytes to cache.
-        /// </summary>
-        public long Total { get; private set; }
-        /// <summary>
-        /// Gets the overall percentage of progress of caching.
-        /// </summary>
-        public int OverallPercentage { get; private set; }
    }
    /// <summary>
@@ -1428,25 +1327,23 @@ namespace WixToolset.Mba.Core
    }
    /// <summary>
-    /// Additional arguments used when the engine starts the verification of a payload.
+    /// EventArgs for <see cref="IDefaultBootstrapperApplication.CacheVerifyBegin"/>.
    /// </summary>
    [Serializable]
    public class CacheVerifyBeginEventArgs : CancellableHResultEventArgs
    {
-        /// <summary>
+        /// <summary />
-        /// Creates a new instance of the <see cref="CacheVerifyBeginEventArgs"/> class.
+        public CacheVerifyBeginEventArgs(string packageOrContainerId, string payloadId, bool cancelRecommendation)
-        /// </summary>
-        public CacheVerifyBeginEventArgs(string packageId, string payloadId, bool cancelRecommendation)
            : base(cancelRecommendation)
        {
-            this.PackageId = packageId;
+            this.PackageOrContainerId = packageOrContainerId;
            this.PayloadId = payloadId;
        }
        /// <summary>
-        /// Gets the identifier of the package.
+        /// Gets the identifier of the container or package.
        /// </summary>
-        public string PackageId { get; private set; }
+        public string PackageOrContainerId { get; private set; }
        /// <summary>
        /// Gets the identifier of the payload.
@@ -1455,25 +1352,42 @@ namespace WixToolset.Mba.Core
    }
    /// <summary>
-    /// Additional arguments used when the engine completes the verification of a payload.
+    /// EventArgs for <see cref="IDefaultBootstrapperApplication.CacheVerifyProgress"/>.
    /// </summary>
    [Serializable]
-    public class CacheVerifyCompleteEventArgs : ActionEventArgs<BOOTSTRAPPER_CACHEVERIFYCOMPLETE_ACTION>
+    public class CacheVerifyProgressEventArgs : CacheProgressBaseEventArgs
    {
+        /// <summary />
+        public CacheVerifyProgressEventArgs(string packageOrContainerId, string payloadId, long progress, long total, int overallPercentage, CacheVerifyStep verifyStep, bool cancelRecommendation)
+            : base(packageOrContainerId, payloadId, progress, total, overallPercentage, cancelRecommendation)
+        {
+            this.Step = verifyStep;
+        }
        /// <summary>
-        /// Creates a new instance of the <see cref="CacheVerifyCompleteEventArgs"/> class.
+        /// Gets the current verification step.
        /// </summary>
-        public CacheVerifyCompleteEventArgs(string packageId, string payloadId, int hrStatus, BOOTSTRAPPER_CACHEVERIFYCOMPLETE_ACTION recommendation, BOOTSTRAPPER_CACHEVERIFYCOMPLETE_ACTION action)
+        public CacheVerifyStep Step { get; private set; }
+    }
+    /// <summary>
+    /// Event arguments for <see cref="IDefaultBootstrapperApplication.CacheVerifyComplete"/>
+    /// </summary>
+    [Serializable]
+    public class CacheVerifyCompleteEventArgs : ActionEventArgs<BOOTSTRAPPER_CACHEVERIFYCOMPLETE_ACTION>
+    {
+        /// <summary />
+        public CacheVerifyCompleteEventArgs(string packageOrContainerId, string payloadId, int hrStatus, BOOTSTRAPPER_CACHEVERIFYCOMPLETE_ACTION recommendation, BOOTSTRAPPER_CACHEVERIFYCOMPLETE_ACTION action)
            : base(hrStatus, recommendation, action)
        {
-            this.PackageId = packageId;
+            this.PackageOrContainerId = packageOrContainerId;
            this.PayloadId = payloadId;
        }
        /// <summary>
-        /// Gets the identifier of the package.
+        /// Gets the identifier of the container or package.
        /// </summary>
-        public string PackageId { get; private set; }
+        public string PackageOrContainerId { get; private set; }
        /// <summary>
        /// Gets the identifier of the payload.
@@ -1498,16 +1412,12 @@ namespace WixToolset.Mba.Core
    }
    /// <summary>
-    /// Additional arguments used when the engine has begun installing packages.
+    /// Event arguments for <see cref="IDefaultBootstrapperApplication.ExecuteBegin"/>
    /// </summary>
    [Serializable]
    public class ExecuteBeginEventArgs : CancellableHResultEventArgs
    {
-        /// <summary>
+        /// <summary />
-        /// Creates a new instance of the <see cref="ExecuteBeginEventArgs"/> class.
-        /// </summary>
-        /// <param name="packageCount">The number of packages to act on.</param>
-        /// <param name="cancelRecommendation">The recommendation from the engine.</param>
        public ExecuteBeginEventArgs(int packageCount, bool cancelRecommendation)
            : base(cancelRecommendation)
        {
@@ -1521,20 +1431,12 @@ namespace WixToolset.Mba.Core
    }
    /// <summary>
-    /// Additional arguments used when the engine has begun installing a specific package.
+    /// Event arguments for <see cref="IDefaultBootstrapperApplication.ExecutePackageBegin"/>
    /// </summary>
    [Serializable]
    public class ExecutePackageBeginEventArgs : CancellableHResultEventArgs
    {
-        /// <summary>
+        /// <summary />
-        /// Creates a new instance of the <see cref="ExecutePackageBeginEventArgs"/> class.
-        /// </summary>
-        /// <param name="packageId">The identity of the package to act on.</param>
-        /// <param name="shouldExecute">Whether the package is being executed or rolled back.</param>
-        /// <param name="action">The action about to be executed.</param>
-        /// <param name="uiLevel">The internal UI level (if this is an MSI or MSP package).</param>
-        /// <param name="disableExternalUiHandler">Whether Burn will set up an external UI handler (if this is an MSI or MSP package).</param>
-        /// <param name="cancelRecommendation">The recommendation from the engine.</param>
        public ExecutePackageBeginEventArgs(string packageId, bool shouldExecute, ActionState action, INSTALLUILEVEL uiLevel, bool disableExternalUiHandler, bool cancelRecommendation)
            : base(cancelRecommendation)
        {
@@ -1572,17 +1474,12 @@ namespace WixToolset.Mba.Core
    }
    /// <summary>
-    /// Additional arguments used when the engine executes one or more patches targeting a product.
+    /// Event arguments for <see cref="IDefaultBootstrapperApplication.ExecutePatchTarget"/>
    /// </summary>
    [Serializable]
    public class ExecutePatchTargetEventArgs : CancellableHResultEventArgs
    {
-        /// <summary>
+        /// <summary />
-        /// Creates a new instance of the <see cref="ExecutePatchTargetEventArgs"/> class.
-        /// </summary>
-        /// <param name="packageId">The identity of the package to act on.</param>
-        /// <param name="targetProductCode">The product code of the target of the patch.</param>
-        /// <param name="cancelRecommendation">The recommendation from the engine.</param>
        public ExecutePatchTargetEventArgs(string packageId, string targetProductCode, bool cancelRecommendation)
            : base(cancelRecommendation)
        {
@@ -1602,21 +1499,12 @@ namespace WixToolset.Mba.Core
    }
    /// <summary>
-    /// Additional arguments used when Windows Installer sends an installation message.
+    /// Event arguments for <see cref="IDefaultBootstrapperApplication.ExecuteMsiMessage"/>
    /// </summary>
    [Serializable]
    public class ExecuteMsiMessageEventArgs : ResultEventArgs
    {
-        /// <summary>
+        /// <summary />
-        /// Creates a new instance of the <see cref="ExecuteMsiMessageEventArgs"/> class.
-        /// </summary>
-        /// <param name="packageId">The identity of the package that yielded this message.</param>
-        /// <param name="messageType">The type of this message.</param>
-        /// <param name="dwUIHint">Recommended display flags for this message.</param>
-        /// <param name="message">The message.</param>
-        /// <param name="data">The extended data for the message.</param>
-        /// <param name="recommendation">Recommended result from engine.</param>
-        /// <param name="result">The result to return to the engine.</param>
        public ExecuteMsiMessageEventArgs(string packageId, InstallMessage messageType, int dwUIHint, string message, string[] data, Result recommendation, Result result)
            : base(recommendation, result)
        {
@@ -1654,18 +1542,12 @@ namespace WixToolset.Mba.Core
    }
    /// <summary>
-    /// Additional arugments used for file in use installation messages.
+    /// Event arguments for <see cref="IDefaultBootstrapperApplication.ExecuteFilesInUse"/>
    /// </summary>
    [Serializable]
    public class ExecuteFilesInUseEventArgs : ResultEventArgs
    {
-        /// <summary>
+        /// <summary />
-        /// Creates a new instance of the <see cref="ExecuteFilesInUseEventArgs"/> class.
-        /// </summary>
-        /// <param name="packageId">The identity of the package that yielded the files in use message.</param>
-        /// <param name="files">The list of files in use.</param>
-        /// <param name="recommendation">Recommended result from engine.</param>
-        /// <param name="result">The result to return to the engine.</param>
        public ExecuteFilesInUseEventArgs(string packageId, string[] files, Result recommendation, Result result)
            : base(recommendation, result)
        {
@@ -1685,19 +1567,13 @@ namespace WixToolset.Mba.Core
    }
    /// <summary>
+    /// Event arguments for <see cref="IDefaultBootstrapperApplication.ExecutePackageComplete"/>
    /// Additional arguments used when the engine has completed installing a specific package.
    /// </summary>
    [Serializable]
    public class ExecutePackageCompleteEventArgs : ActionEventArgs<BOOTSTRAPPER_EXECUTEPACKAGECOMPLETE_ACTION>
    {
-        /// <summary>
+        /// <summary />
-        /// Creates a new instance of the <see cref="ExecutePackageCompleteEventArgs"/> class.
-        /// </summary>
-        /// <param name="packageId">The identity of the package that was acted on.</param>
-        /// <param name="hrStatus">The return code of the operation.</param>
-        /// <param name="restart">Whether a restart is required.</param>
-        /// <param name="recommendation">Recommended action from engine.</param>
-        /// <param name="action">The action to perform.</param>
        public ExecutePackageCompleteEventArgs(string packageId, int hrStatus, ApplyRestart restart, BOOTSTRAPPER_EXECUTEPACKAGECOMPLETE_ACTION recommendation, BOOTSTRAPPER_EXECUTEPACKAGECOMPLETE_ACTION action)
            : base(hrStatus, recommendation, action)
        {
@@ -1733,18 +1609,12 @@ namespace WixToolset.Mba.Core
    }
    /// <summary>
-    /// Additional arguments used when the engine has completed installing the bundle.
+    /// Event arguments for <see cref="IDefaultBootstrapperApplication.ApplyComplete"/>
    /// </summary>
    [Serializable]
    public class ApplyCompleteEventArgs : ActionEventArgs<BOOTSTRAPPER_APPLYCOMPLETE_ACTION>
    {
-        /// <summary>
+        /// <summary />
-        /// Creates a new instance of the <see cref="ApplyCompleteEventArgs"/> clas.
-        /// </summary>
-        /// <param name="hrStatus">The return code of the operation.</param>
-        /// <param name="restart">Whether a restart is required.</param>
-        /// <param name="recommendation">Recommended action from engine.</param>
-        /// <param name="action">The action to perform.</param>
        public ApplyCompleteEventArgs(int hrStatus, ApplyRestart restart, BOOTSTRAPPER_APPLYCOMPLETE_ACTION recommendation, BOOTSTRAPPER_APPLYCOMPLETE_ACTION action)
            : base(hrStatus, recommendation, action)
        {
@@ -1819,18 +1689,12 @@ namespace WixToolset.Mba.Core
    }
    /// <summary>
-    /// Additional arguments used by the engine when it has begun caching a specific package.
+    /// Event arguments for <see cref="IDefaultBootstrapperApplication.CachePackageBegin"/>
    /// </summary>
    [Serializable]
    public class CachePackageBeginEventArgs : CancellableHResultEventArgs
    {
-        /// <summary>
+        /// <summary />
-        /// Creates a new instance of the <see cref="CachePackageBeginEventArgs"/> class.
-        /// </summary>
-        /// <param name="packageId">The identity of the package that is being cached.</param>
-        /// <param name="cachePayloads">Number of payloads to be cached.</param>
-        /// <param name="packageCacheSize">The size on disk required by the specific package.</param>
-        /// <param name="cancelRecommendation">The recommendation from the engine.</param>
        public CachePackageBeginEventArgs(string packageId, int cachePayloads, long packageCacheSize, bool cancelRecommendation)
            : base(cancelRecommendation)
        {
@@ -1856,18 +1720,12 @@ namespace WixToolset.Mba.Core
    }
    /// <summary>
-    /// Additional arguments passed by the engine when it has completed caching a specific package.
+    /// Event arguments for <see cref="IDefaultBootstrapperApplication.CachePackageComplete"/>
    /// </summary>
    [Serializable]
    public class CachePackageCompleteEventArgs : ActionEventArgs<BOOTSTRAPPER_CACHEPACKAGECOMPLETE_ACTION>
    {
-        /// <summary>
+        /// <summary />
-        /// Creates a new instance of the <see cref="CachePackageCompleteEventArgs"/> class.
-        /// </summary>
-        /// <param name="packageId">The identity of the package that was cached.</param>
-        /// <param name="hrStatus">The return code of the operation.</param>
-        /// <param name="recommendation">Recommended action from engine.</param>
-        /// <param name="action">The action to perform.</param>
        public CachePackageCompleteEventArgs(string packageId, int hrStatus, BOOTSTRAPPER_CACHEPACKAGECOMPLETE_ACTION recommendation, BOOTSTRAPPER_CACHEPACKAGECOMPLETE_ACTION action)
            : base(hrStatus, recommendation, action)
        {
@@ -1881,18 +1739,12 @@ namespace WixToolset.Mba.Core
    }
    /// <summary>
-    /// Additional arguments passed by the engine while executing on payload.
+    /// Event arguments for <see cref="IDefaultBootstrapperApplication.ExecuteProgress"/>
    /// </summary>
    [Serializable]
    public class ExecuteProgressEventArgs : CancellableHResultEventArgs
    {
-        /// <summary>
+        /// <summary />
-        /// Creates a new instance of the <see cref="ExecuteProgressEventArgs"/> class.
-        /// </summary>
-        /// <param name="packageId">The identifier of the package being executed.</param>
-        /// <param name="progressPercentage">The percentage from 0 to 100 of the execution progress for a single payload.</param>
-        /// <param name="overallPercentage">The percentage from 0 to 100 of the execution progress for all payload.</param>
-        /// <param name="cancelRecommendation">The recommendation from the engine.</param>
        public ExecuteProgressEventArgs(string packageId, int progressPercentage, int overallPercentage, bool cancelRecommendation)
            : base(cancelRecommendation)
        {
@@ -2187,4 +2039,130 @@ namespace WixToolset.Mba.Core
        {
        }
    }
+    /// <summary>
+    /// EventArgs for <see cref="IDefaultBootstrapperApplication.CacheContainerOrPayloadVerifyBegin"/>.
+    /// </summary>
+    [Serializable]
+    public class CacheContainerOrPayloadVerifyBeginEventArgs : CancellableHResultEventArgs
+    {
+        /// <summary />
+        public CacheContainerOrPayloadVerifyBeginEventArgs(string packageOrContainerId, string payloadId, bool cancelRecommendation)
+            : base(cancelRecommendation)
+        {
+            this.PackageOrContainerId = packageOrContainerId;
+            this.PayloadId = payloadId;
+        }
+        /// <summary>
+        /// Gets the identifier of the container or package.
+        /// </summary>
+        public string PackageOrContainerId { get; private set; }
+        /// <summary>
+        /// Gets the identifier of the payload.
+        /// </summary>
+        public string PayloadId { get; private set; }
+    }
+    /// <summary>
+    /// EventArgs for <see cref="IDefaultBootstrapperApplication.CacheContainerOrPayloadVerifyProgress"/>.
+    /// </summary>
+    [Serializable]
+    public class CacheContainerOrPayloadVerifyProgressEventArgs : CacheProgressBaseEventArgs
+    {
+        /// <summary />
+        public CacheContainerOrPayloadVerifyProgressEventArgs(string packageOrContainerId, string payloadId, long progress, long total, int overallPercentage, bool cancelRecommendation)
+            : base(packageOrContainerId, payloadId, progress, total, overallPercentage, cancelRecommendation)
+        {
+        }
+    }
+    /// <summary>
+    /// Event arguments for <see cref="IDefaultBootstrapperApplication.CacheContainerOrPayloadVerifyComplete"/>
+    /// </summary>
+    [Serializable]
+    public class CacheContainerOrPayloadVerifyCompleteEventArgs : StatusEventArgs
+    {
+        /// <summary />
+        public CacheContainerOrPayloadVerifyCompleteEventArgs(string packageOrContainerId, string payloadId, int hrStatus)
+            : base(hrStatus)
+        {
+            this.PackageOrContainerId = packageOrContainerId;
+            this.PayloadId = payloadId;
+        }
+        /// <summary>
+        /// Gets the identifier of the container or package.
+        /// </summary>
+        public string PackageOrContainerId { get; private set; }
+        /// <summary>
+        /// Gets the identifier of the payload.
+        /// </summary>
+        public string PayloadId { get; private set; }
+    }
+    /// <summary>
+    /// EventArgs for <see cref="IDefaultBootstrapperApplication.CachePayloadExtractBegin"/>.
+    /// </summary>
+    [Serializable]
+    public class CachePayloadExtractBeginEventArgs : CancellableHResultEventArgs
+    {
+        /// <summary />
+        public CachePayloadExtractBeginEventArgs(string containerId, string payloadId, bool cancelRecommendation)
+            : base(cancelRecommendation)
+        {
+            this.ContainerId = containerId;
+            this.PayloadId = payloadId;
+        }
+        /// <summary>
+        /// Gets the identifier of the container.
+        /// </summary>
+        public string ContainerId { get; private set; }
+        /// <summary>
+        /// Gets the identifier of the payload.
+        /// </summary>
+        public string PayloadId { get; private set; }
+    }
+    /// <summary>
+    /// EventArgs for <see cref="IDefaultBootstrapperApplication.CachePayloadExtractProgress"/>.
+    /// </summary>
+    [Serializable]
+    public class CachePayloadExtractProgressEventArgs : CacheProgressBaseEventArgs
+    {
+        /// <summary />
+        public CachePayloadExtractProgressEventArgs(string containerId, string payloadId, long progress, long total, int overallPercentage, bool cancelRecommendation)
+            : base(containerId, payloadId, progress, total, overallPercentage, cancelRecommendation)
+        {
+        }
+    }
+    /// <summary>
+    /// Event arguments for <see cref="IDefaultBootstrapperApplication.CachePayloadExtractComplete"/>
+    /// </summary>
+    [Serializable]
+    public class CachePayloadExtractCompleteEventArgs : StatusEventArgs
+    {
+        /// <summary />
+        public CachePayloadExtractCompleteEventArgs(string containerId, string payloadId, int hrStatus)
+            : base(hrStatus)
+        {
+            this.ContainerId = containerId;
+            this.PayloadId = payloadId;
+        }
+        /// <summary>
+        /// Gets the identifier of the container.
+        /// </summary>
+        public string ContainerId { get; private set; }
+        /// <summary>
+        /// Gets the identifier of the payload.
+        /// </summary>
+        public string PayloadId { get; private set; }
+    }
 }
diff --git a/src/WixToolset.Mba.Core/IBootstrapperApplication.cs b/src/WixToolset.Mba.Core/IBootstrapperApplication.cs
index 88c65674..2195fd4b 100644
--- a/src/WixToolset.Mba.Core/IBootstrapperApplication.cs
+++ b/src/WixToolset.Mba.Core/IBootstrapperApplication.cs
@@ -3,7 +3,6 @@
 namespace WixToolset.Mba.Core
 {
    using System;
-    using System.CodeDom.Compiler;
    using System.Runtime.InteropServices;
    /// <summary>
@@ -15,6 +14,29 @@ namespace WixToolset.Mba.Core
    public interface IBootstrapperApplication
    {
        /// <summary>
+        /// Low level method that is called directly from the engine.
+        /// </summary>
+        [PreserveSig]
+        [return: MarshalAs(UnmanagedType.I4)]
+        int BAProc(
+            int message,
+            IntPtr pvArgs,
+            IntPtr pvResults,
+            IntPtr pvContext
+            );
+        /// <summary>
+        /// Low level method that is called directly from the engine.
+        /// </summary>
+        void BAProcFallback(
+            int message,
+            IntPtr pvArgs,
+            IntPtr pvResults,
+            ref int phr,
+            IntPtr pvContext
+            );
+        /// <summary>
        /// See <see cref="IDefaultBootstrapperApplication.Startup"/>.
        /// </summary>
        [PreserveSig]
@@ -600,31 +622,36 @@ namespace WixToolset.Mba.Core
        /// <summary>
        /// See <see cref="IDefaultBootstrapperApplication.CacheVerifyBegin"/>.
        /// </summary>
-        /// <param name="wzPackageId"></param>
-        /// <param name="wzPayloadId"></param>
-        /// <param name="fCancel"></param>
-        /// <returns></returns>
        [PreserveSig]
        [return: MarshalAs(UnmanagedType.I4)]
        int OnCacheVerifyBegin(
-            [MarshalAs(UnmanagedType.LPWStr)] string wzPackageId,
+            [MarshalAs(UnmanagedType.LPWStr)] string wzPackageOrContainerId,
            [MarshalAs(UnmanagedType.LPWStr)] string wzPayloadId,
            [MarshalAs(UnmanagedType.Bool)] ref bool fCancel
            );
        /// <summary>
+        /// See <see cref="IDefaultBootstrapperApplication.CacheVerifyProgress"/>.
+        /// </summary>
+        [PreserveSig]
+        [return: MarshalAs(UnmanagedType.I4)]
+        int OnCacheVerifyProgress(
+            [MarshalAs(UnmanagedType.LPWStr)] string wzPackageOrContainerId,
+            [MarshalAs(UnmanagedType.LPWStr)] string wzPayloadId,
+            [MarshalAs(UnmanagedType.U8)] long dw64Progress,
+            [MarshalAs(UnmanagedType.U8)] long dw64Total,
+            [MarshalAs(UnmanagedType.U4)] int dwOverallPercentage,
+            [MarshalAs(UnmanagedType.I4)] CacheVerifyStep verifyStep,
+            [MarshalAs(UnmanagedType.Bool)] ref bool fCancel
+            );
+        /// <summary>
        /// See <see cref="IDefaultBootstrapperApplication.CacheVerifyComplete"/>.
        /// </summary>
-        /// <param name="wzPackageId"></param>
-        /// <param name="wzPayloadId"></param>
-        /// <param name="hrStatus"></param>
-        /// <param name="recommendation"></param>
-        /// <param name="action"></param>
-        /// <returns></returns>
        [PreserveSig]
        [return: MarshalAs(UnmanagedType.I4)]
        int OnCacheVerifyComplete(
-            [MarshalAs(UnmanagedType.LPWStr)] string wzPackageId,
+            [MarshalAs(UnmanagedType.LPWStr)] string wzPackageOrContainerId,
            [MarshalAs(UnmanagedType.LPWStr)] string wzPayloadId,
            int hrStatus,
            BOOTSTRAPPER_CACHEVERIFYCOMPLETE_ACTION recommendation,
@@ -1006,36 +1033,75 @@ namespace WixToolset.Mba.Core
            );
        /// <summary>
-        /// Low level method that is called directly from the engine.
+        /// See <see cref="IDefaultBootstrapperApplication.CacheContainerOrPayloadVerifyBegin"/>.
        /// </summary>
-        /// <param name="message"></param>
-        /// <param name="pvArgs"></param>
-        /// <param name="pvResults"></param>
-        /// <param name="pvContext"></param>
-        /// <returns></returns>
        [PreserveSig]
        [return: MarshalAs(UnmanagedType.I4)]
-        int BAProc(
+        int OnCacheContainerOrPayloadVerifyBegin(
-            int message,
+            [MarshalAs(UnmanagedType.LPWStr)] string wzPackageId,
-            IntPtr pvArgs,
+            [MarshalAs(UnmanagedType.LPWStr)] string wzPayloadId,
-            IntPtr pvResults,
+            [MarshalAs(UnmanagedType.Bool)] ref bool fCancel
-            IntPtr pvContext
            );
        /// <summary>
-        /// Low level method that is called directly from the engine.
+        /// See <see cref="IDefaultBootstrapperApplication.CacheContainerOrPayloadVerifyProgress"/>.
        /// </summary>
-        /// <param name="message"></param>
+        [PreserveSig]
-        /// <param name="pvArgs"></param>
+        [return: MarshalAs(UnmanagedType.I4)]
-        /// <param name="pvResults"></param>
+        int OnCacheContainerOrPayloadVerifyProgress(
-        /// <param name="phr"></param>
+            [MarshalAs(UnmanagedType.LPWStr)] string wzPackageOrContainerId,
-        /// <param name="pvContext"></param>
+            [MarshalAs(UnmanagedType.LPWStr)] string wzPayloadId,
-        void BAProcFallback(
+            [MarshalAs(UnmanagedType.U8)] long dw64Progress,
-            int message,
+            [MarshalAs(UnmanagedType.U8)] long dw64Total,
-            IntPtr pvArgs,
+            [MarshalAs(UnmanagedType.U4)] int dwOverallPercentage,
-            IntPtr pvResults,
+            [MarshalAs(UnmanagedType.Bool)] ref bool fCancel
-            ref int phr,
+            );
-            IntPtr pvContext
+        /// <summary>
+        /// See <see cref="IDefaultBootstrapperApplication.CacheContainerOrPayloadVerifyComplete"/>.
+        /// </summary>
+        [PreserveSig]
+        [return: MarshalAs(UnmanagedType.I4)]
+        int OnCacheContainerOrPayloadVerifyComplete(
+            [MarshalAs(UnmanagedType.LPWStr)] string wzPackageId,
+            [MarshalAs(UnmanagedType.LPWStr)] string wzPayloadId,
+            int hrStatus
+            );
+        /// <summary>
+        /// See <see cref="IDefaultBootstrapperApplication.CachePayloadExtractBegin"/>.
+        /// </summary>
+        [PreserveSig]
+        [return: MarshalAs(UnmanagedType.I4)]
+        int OnCachePayloadExtractBegin(
+            [MarshalAs(UnmanagedType.LPWStr)] string wzPackageId,
+            [MarshalAs(UnmanagedType.LPWStr)] string wzPayloadId,
+            [MarshalAs(UnmanagedType.Bool)] ref bool fCancel
+            );
+        /// <summary>
+        /// See <see cref="IDefaultBootstrapperApplication.CachePayloadExtractProgress"/>.
+        /// </summary>
+        [PreserveSig]
+        [return: MarshalAs(UnmanagedType.I4)]
+        int OnCachePayloadExtractProgress(
+            [MarshalAs(UnmanagedType.LPWStr)] string wzPackageOrContainerId,
+            [MarshalAs(UnmanagedType.LPWStr)] string wzPayloadId,
+            [MarshalAs(UnmanagedType.U8)] long dw64Progress,
+            [MarshalAs(UnmanagedType.U8)] long dw64Total,
+            [MarshalAs(UnmanagedType.U4)] int dwOverallPercentage,
+            [MarshalAs(UnmanagedType.Bool)] ref bool fCancel
+            );
+        /// <summary>
+        /// See <see cref="IDefaultBootstrapperApplication.CachePayloadExtractComplete"/>.
+        /// </summary>
+        [PreserveSig]
+        [return: MarshalAs(UnmanagedType.I4)]
+        int OnCachePayloadExtractComplete(
+            [MarshalAs(UnmanagedType.LPWStr)] string wzPackageId,
+            [MarshalAs(UnmanagedType.LPWStr)] string wzPayloadId,
+            int hrStatus
            );
    }
@@ -1449,6 +1515,26 @@ namespace WixToolset.Mba.Core
    }
    /// <summary>
+    /// The current step when verifying a container or payload.
+    /// </summary>
+    public enum CacheVerifyStep
+    {
+        /// <summary>
+        /// Copying or moving the file from the working path to the unverified path.
+        /// Not used during Layout.
+        /// </summary>
+        Stage,
+        /// <summary>
+        /// Hashing the file.
+        /// </summary>
+        Hash,
+        /// <summary>
+        /// Copying or moving the file to the final location.
+        /// </summary>
+        Finalize,
+    }
+    /// <summary>
    /// The restart state after a package or all packages were applied.
    /// </summary>
    public enum ApplyRestart
@@ -1566,7 +1652,7 @@ namespace WixToolset.Mba.Core
        None,
        /// <summary>
-        /// Instructs the engine to try the acquisition of the package again.
+        /// Instructs the engine to try the acquisition of the payload again.
        /// Ignored if hrStatus is a success.
        /// </summary>
        Retry,
diff --git a/src/WixToolset.Mba.Core/IDefaultBootstrapperApplication.cs b/src/WixToolset.Mba.Core/IDefaultBootstrapperApplication.cs
index 03f94d37..a295f6c0 100644
--- a/src/WixToolset.Mba.Core/IDefaultBootstrapperApplication.cs
+++ b/src/WixToolset.Mba.Core/IDefaultBootstrapperApplication.cs
@@ -44,7 +44,7 @@ namespace WixToolset.Mba.Core
        event EventHandler<CacheAcquireCompleteEventArgs> CacheAcquireComplete;
        /// <summary>
-        /// Fired when the engine has progress acquiring the installation sources.
+        /// Fired when the engine has progress acquiring the payload or container.
        /// </summary>
        event EventHandler<CacheAcquireProgressEventArgs> CacheAcquireProgress;
@@ -64,6 +64,21 @@ namespace WixToolset.Mba.Core
        event EventHandler<CacheCompleteEventArgs> CacheComplete;
        /// <summary>
+        /// Fired when the engine begins the verification of the payload or container that was already in the package cache.
+        /// </summary>
+        event EventHandler<CacheContainerOrPayloadVerifyBeginEventArgs> CacheContainerOrPayloadVerifyBegin;
+        /// <summary>
+        /// Fired when the engine has completed the verification of the payload or container that was already in the package cache.
+        /// </summary>
+        event EventHandler<CacheContainerOrPayloadVerifyCompleteEventArgs> CacheContainerOrPayloadVerifyComplete;
+        /// <summary>
+        /// Fired when the engine has progress verifying the payload or container that was already in the package cache.
+        /// </summary>
+        event EventHandler<CacheContainerOrPayloadVerifyProgressEventArgs> CacheContainerOrPayloadVerifyProgress;
+        /// <summary>
        /// Fired when the engine has begun caching a specific package.
        /// </summary>
        event EventHandler<CachePackageBeginEventArgs> CachePackageBegin;
@@ -74,16 +89,36 @@ namespace WixToolset.Mba.Core
        event EventHandler<CachePackageCompleteEventArgs> CachePackageComplete;
        /// <summary>
-        /// Fired when the engine begins the verification of the acquired installation sources.
+        /// Fired when the engine begins the extraction of the payload from the container.
+        /// </summary>
+        event EventHandler<CachePayloadExtractBeginEventArgs> CachePayloadExtractBegin;
+        /// <summary>
+        /// Fired when the engine has completed the extraction of the payload from the container.
+        /// </summary>
+        event EventHandler<CachePayloadExtractCompleteEventArgs> CachePayloadExtractComplete;
+        /// <summary>
+        /// Fired when the engine has progress extracting the payload from the container.
+        /// </summary>
+        event EventHandler<CachePayloadExtractProgressEventArgs> CachePayloadExtractProgress;
+        /// <summary>
+        /// Fired when the engine begins the verification of the acquired payload or container.
        /// </summary>
        event EventHandler<CacheVerifyBeginEventArgs> CacheVerifyBegin;
        /// <summary>
-        /// Fired when the engine complete the verification of the acquired installation sources.
+        /// Fired when the engine has completed the verification of the acquired payload or container.
        /// </summary>
        event EventHandler<CacheVerifyCompleteEventArgs> CacheVerifyComplete;
        /// <summary>
+        /// Fired when the engine has progress verifying the payload or container.
+        /// </summary>
+        event EventHandler<CacheVerifyProgressEventArgs> CacheVerifyProgress;
+        /// <summary>
        /// Fired when the engine is about to commit an MSI transaction.
        /// </summary>
        event EventHandler<CommitMsiTransactionBeginEventArgs> CommitMsiTransactionBegin;
@@ -179,7 +214,7 @@ namespace WixToolset.Mba.Core
        event EventHandler<ExecuteCompleteEventArgs> ExecuteComplete;
        /// <summary>
-        /// Fired when Windows Installer sends a files in use installation message.
+        /// Fired when a package sends a files in use installation message.
        /// </summary>
        event EventHandler<ExecuteFilesInUseEventArgs> ExecuteFilesInUse;
@@ -204,7 +239,7 @@ namespace WixToolset.Mba.Core
        event EventHandler<ExecutePatchTargetEventArgs> ExecutePatchTarget;
        /// <summary>
-        /// Fired by the engine while executing on payload.
+        /// Fired by the engine while executing a package.
        /// </summary>
        event EventHandler<ExecuteProgressEventArgs> ExecuteProgress;
diff --git a/src/balutil/inc/BAFunctions.h b/src/balutil/inc/BAFunctions.h
index 07f7a750..2970478f 100644
--- a/src/balutil/inc/BAFunctions.h
+++ b/src/balutil/inc/BAFunctions.h
@@ -74,6 +74,13 @@ enum BA_FUNCTIONS_MESSAGE
    BA_FUNCTIONS_MESSAGE_ONSYSTEMRESTOREPOINTCOMPLETE = BOOTSTRAPPER_APPLICATION_MESSAGE_ONSYSTEMRESTOREPOINTCOMPLETE,
    BA_FUNCTIONS_MESSAGE_ONPLANNEDPACKAGE = BOOTSTRAPPER_APPLICATION_MESSAGE_ONPLANNEDPACKAGE,
    BA_FUNCTIONS_MESSAGE_ONPLANFORWARDCOMPATIBLEBUNDLE = BOOTSTRAPPER_APPLICATION_MESSAGE_ONPLANFORWARDCOMPATIBLEBUNDLE,
+    BA_FUNCTIONS_MESSAGE_ONCACHEVERIFYPROGRESS = BOOTSTRAPPER_APPLICATION_MESSAGE_ONCACHEVERIFYPROGRESS,
+    BA_FUNCTIONS_MESSAGE_ONCACHECONTAINERORPAYLOADVERIFYBEGIN = BOOTSTRAPPER_APPLICATION_MESSAGE_ONCACHECONTAINERORPAYLOADVERIFYBEGIN,
+    BA_FUNCTIONS_MESSAGE_ONCACHECONTAINERORPAYLOADVERIFYCOMPLETE = BOOTSTRAPPER_APPLICATION_MESSAGE_ONCACHECONTAINERORPAYLOADVERIFYCOMPLETE,
+    BA_FUNCTIONS_MESSAGE_ONCACHECONTAINERORPAYLOADVERIFYPROGRESS = BOOTSTRAPPER_APPLICATION_MESSAGE_ONCACHECONTAINERORPAYLOADVERIFYPROGRESS,
+    BA_FUNCTIONS_MESSAGE_ONCACHEPAYLOADEXTRACTBEGIN = BOOTSTRAPPER_APPLICATION_MESSAGE_ONCACHEPAYLOADEXTRACTBEGIN,
+    BA_FUNCTIONS_MESSAGE_ONCACHEPAYLOADEXTRACTCOMPLETE = BOOTSTRAPPER_APPLICATION_MESSAGE_ONCACHEPAYLOADEXTRACTCOMPLETE,
+    BA_FUNCTIONS_MESSAGE_ONCACHEPAYLOADEXTRACTPROGRESS = BOOTSTRAPPER_APPLICATION_MESSAGE_ONCACHEPAYLOADEXTRACTPROGRESS,
    BA_FUNCTIONS_MESSAGE_ONTHEMELOADED = 1024,
    BA_FUNCTIONS_MESSAGE_WNDPROC,
diff --git a/src/balutil/inc/BalBaseBAFunctions.h b/src/balutil/inc/BalBaseBAFunctions.h
index ca727f49..054bfb26 100644
--- a/src/balutil/inc/BalBaseBAFunctions.h
+++ b/src/balutil/inc/BalBaseBAFunctions.h
@@ -69,6 +69,26 @@ public: // IUnknown
    }
 public: // IBootstrapperApplication
+    virtual STDMETHODIMP_(HRESULT) BAProc(
+        __in BOOTSTRAPPER_APPLICATION_MESSAGE /*message*/,
+        __in const LPVOID /*pvArgs*/,
+        __inout LPVOID /*pvResults*/,
+        __in_opt LPVOID /*pvContext*/
+        )
+    {
+        return E_NOTIMPL;
+    }
+    virtual STDMETHODIMP_(void) BAProcFallback(
+        __in BOOTSTRAPPER_APPLICATION_MESSAGE /*message*/,
+        __in const LPVOID /*pvArgs*/,
+        __inout LPVOID /*pvResults*/,
+        __inout HRESULT* /*phr*/,
+        __in_opt LPVOID /*pvContext*/
+        )
+    {
+    }
    virtual STDMETHODIMP OnStartup()
    {
        return S_OK;
@@ -439,7 +459,7 @@ public: // IBootstrapperApplication
    }
    virtual STDMETHODIMP OnCacheVerifyBegin(
-        __in_z LPCWSTR /*wzPackageId*/,
+        __in_z LPCWSTR /*wzPackageOrContainerId*/,
        __in_z LPCWSTR /*wzPayloadId*/,
        __inout BOOL* /*pfCancel*/
        )
@@ -447,8 +467,21 @@ public: // IBootstrapperApplication
        return S_OK;
    }
+    virtual STDMETHODIMP OnCacheVerifyProgress(
+        __in_z_opt LPCWSTR /*wzPackageOrContainerId*/,
+        __in_z_opt LPCWSTR /*wzPayloadId*/,
+        __in DWORD64 /*dw64Progress*/,
+        __in DWORD64 /*dw64Total*/,
+        __in DWORD /*dwOverallPercentage*/,
+        __in BOOTSTRAPPER_CACHE_VERIFY_STEP /*verifyStep*/,
+        __inout BOOL* /*pfCancel*/
+        )
+    {
+        return S_OK;
+    }
    virtual STDMETHODIMP OnCacheVerifyComplete(
-        __in_z LPCWSTR /*wzPackageId*/,
+        __in_z LPCWSTR /*wzPackageOrContainerId*/,
        __in_z LPCWSTR /*wzPayloadId*/,
        __in HRESULT /*hrStatus*/,
        __in BOOTSTRAPPER_CACHEVERIFYCOMPLETE_ACTION /*recommendation*/,
@@ -684,24 +717,64 @@ public: // IBootstrapperApplication
        return S_OK;
    }
-    virtual STDMETHODIMP_(HRESULT) BAProc(
+    virtual STDMETHODIMP OnCacheContainerOrPayloadVerifyBegin(
-        __in BOOTSTRAPPER_APPLICATION_MESSAGE /*message*/,
+        __in_z_opt LPCWSTR /*wzPackageOrContainerId*/,
-        __in const LPVOID /*pvArgs*/,
+        __in_z_opt LPCWSTR /*wzPayloadId*/,
-        __inout LPVOID /*pvResults*/,
+        __inout BOOL* /*pfCancel*/
-        __in_opt LPVOID /*pvContext*/
        )
    {
-        return E_NOTIMPL;
+        return S_OK;
    }
-    virtual STDMETHODIMP_(void) BAProcFallback(
+    virtual STDMETHODIMP OnCacheContainerOrPayloadVerifyProgress(
-        __in BOOTSTRAPPER_APPLICATION_MESSAGE /*message*/,
+        __in_z_opt LPCWSTR /*wzPackageOrContainerId*/,
-        __in const LPVOID /*pvArgs*/,
+        __in_z_opt LPCWSTR /*wzPayloadId*/,
-        __inout LPVOID /*pvResults*/,
+        __in DWORD64 /*dw64Progress*/,
-        __inout HRESULT* /*phr*/,
+        __in DWORD64 /*dw64Total*/,
-        __in_opt LPVOID /*pvContext*/
+        __in DWORD /*dwOverallPercentage*/,
+        __inout BOOL* /*pfCancel*/
+        )
+    {
+        return S_OK;
+    }
+    virtual STDMETHODIMP OnCacheContainerOrPayloadVerifyComplete(
+        __in_z_opt LPCWSTR /*wzPackageOrContainerId*/,
+        __in_z_opt LPCWSTR /*wzPayloadId*/,
+        __in HRESULT /*hrStatus*/
+        )
+    {
+        return S_OK;
+    }
+    virtual STDMETHODIMP OnCachePayloadExtractBegin(
+        __in_z_opt LPCWSTR /*wzPackageOrContainerId*/,
+        __in_z_opt LPCWSTR /*wzPayloadId*/,
+        __inout BOOL* /*pfCancel*/
        )
    {
+        return S_OK;
+    }
+    virtual STDMETHODIMP OnCachePayloadExtractProgress(
+        __in_z_opt LPCWSTR /*wzPackageOrContainerId*/,
+        __in_z_opt LPCWSTR /*wzPayloadId*/,
+        __in DWORD64 /*dw64Progress*/,
+        __in DWORD64 /*dw64Total*/,
+        __in DWORD /*dwOverallPercentage*/,
+        __inout BOOL* /*pfCancel*/
+        )
+    {
+        return S_OK;
+    }
+    virtual STDMETHODIMP OnCachePayloadExtractComplete(
+        __in_z_opt LPCWSTR /*wzPackageOrContainerId*/,
+        __in_z_opt LPCWSTR /*wzPayloadId*/,
+        __in HRESULT /*hrStatus*/
+        )
+    {
+        return S_OK;
    }
 public: // IBAFunctions
diff --git a/src/balutil/inc/BalBaseBootstrapperApplication.h b/src/balutil/inc/BalBaseBootstrapperApplication.h
index 3d3e4ffa..812025eb 100644
--- a/src/balutil/inc/BalBaseBootstrapperApplication.h
+++ b/src/balutil/inc/BalBaseBootstrapperApplication.h
@@ -61,6 +61,26 @@ public: // IUnknown
    }
 public: // IBootstrapperApplication
+    virtual STDMETHODIMP_(HRESULT) BAProc(
+        __in BOOTSTRAPPER_APPLICATION_MESSAGE /*message*/,
+        __in const LPVOID /*pvArgs*/,
+        __inout LPVOID /*pvResults*/,
+        __in_opt LPVOID /*pvContext*/
+        )
+    {
+        return E_NOTIMPL;
+    }
+    virtual STDMETHODIMP_(void) BAProcFallback(
+        __in BOOTSTRAPPER_APPLICATION_MESSAGE /*message*/,
+        __in const LPVOID /*pvArgs*/,
+        __inout LPVOID /*pvResults*/,
+        __inout HRESULT* /*phr*/,
+        __in_opt LPVOID /*pvContext*/
+        )
+    {
+    }
    virtual STDMETHODIMP OnStartup()
    {
        return S_OK;
@@ -540,7 +560,7 @@ public: // IBootstrapperApplication
    }
    virtual STDMETHODIMP OnCacheVerifyBegin(
-        __in_z LPCWSTR /*wzPackageId*/,
+        __in_z LPCWSTR /*wzPackageOrContainerId*/,
        __in_z LPCWSTR /*wzPayloadId*/,
        __inout BOOL* pfCancel
        )
@@ -549,8 +569,22 @@ public: // IBootstrapperApplication
        return S_OK;
    }
+    virtual STDMETHODIMP OnCacheVerifyProgress(
+        __in_z_opt LPCWSTR /*wzPackageOrContainerId*/,
+        __in_z_opt LPCWSTR /*wzPayloadId*/,
+        __in DWORD64 /*dw64Progress*/,
+        __in DWORD64 /*dw64Total*/,
+        __in DWORD /*dwOverallPercentage*/,
+        __in BOOTSTRAPPER_CACHE_VERIFY_STEP /*verifyStep*/,
+        __inout BOOL* pfCancel
+        )
+    {
+        *pfCancel |= CheckCanceled();
+        return S_OK;
+    }
    virtual STDMETHODIMP OnCacheVerifyComplete(
-        __in_z LPCWSTR /*wzPackageId*/,
+        __in_z LPCWSTR /*wzPackageOrContainerId*/,
        __in_z LPCWSTR /*wzPayloadId*/,
        __in HRESULT /*hrStatus*/,
        __in BOOTSTRAPPER_CACHEVERIFYCOMPLETE_ACTION /*recommendation*/,
@@ -870,24 +904,68 @@ public: // IBootstrapperApplication
        return S_OK;
    }
-    virtual STDMETHODIMP_(HRESULT) BAProc(
+    virtual STDMETHODIMP OnCacheContainerOrPayloadVerifyBegin(
-        __in BOOTSTRAPPER_APPLICATION_MESSAGE /*message*/,
+        __in_z_opt LPCWSTR /*wzPackageOrContainerId*/,
-        __in const LPVOID /*pvArgs*/,
+        __in_z_opt LPCWSTR /*wzPayloadId*/,
-        __inout LPVOID /*pvResults*/,
+        __inout BOOL* pfCancel
-        __in_opt LPVOID /*pvContext*/
        )
    {
-        return E_NOTIMPL;
+        *pfCancel |= CheckCanceled();
+        return S_OK;
    }
-    virtual STDMETHODIMP_(void) BAProcFallback(
+    virtual STDMETHODIMP OnCacheContainerOrPayloadVerifyProgress(
-        __in BOOTSTRAPPER_APPLICATION_MESSAGE /*message*/,
+        __in_z_opt LPCWSTR /*wzPackageOrContainerId*/,
-        __in const LPVOID /*pvArgs*/,
+        __in_z_opt LPCWSTR /*wzPayloadId*/,
-        __inout LPVOID /*pvResults*/,
+        __in DWORD64 /*dw64Progress*/,
-        __inout HRESULT* /*phr*/,
+        __in DWORD64 /*dw64Total*/,
-        __in_opt LPVOID /*pvContext*/
+        __in DWORD /*dwOverallPercentage*/,
+        __inout BOOL* pfCancel
        )
    {
+        *pfCancel |= CheckCanceled();
+        return S_OK;
+    }
+    virtual STDMETHODIMP OnCacheContainerOrPayloadVerifyComplete(
+        __in_z_opt LPCWSTR /*wzPackageOrContainerId*/,
+        __in_z_opt LPCWSTR /*wzPayloadId*/,
+        __in HRESULT /*hrStatus*/
+        )
+    {
+        return S_OK;
+    }
+    virtual STDMETHODIMP OnCachePayloadExtractBegin(
+        __in_z_opt LPCWSTR /*wzPackageOrContainerId*/,
+        __in_z_opt LPCWSTR /*wzPayloadId*/,
+        __inout BOOL* pfCancel
+        )
+    {
+        *pfCancel |= CheckCanceled();
+        return S_OK;
+    }
+    virtual STDMETHODIMP OnCachePayloadExtractProgress(
+        __in_z_opt LPCWSTR /*wzPackageOrContainerId*/,
+        __in_z_opt LPCWSTR /*wzPayloadId*/,
+        __in DWORD64 /*dw64Progress*/,
+        __in DWORD64 /*dw64Total*/,
+        __in DWORD /*dwOverallPercentage*/,
+        __inout BOOL* pfCancel
+        )
+    {
+        *pfCancel |= CheckCanceled();
+        return S_OK;
+    }
+    virtual STDMETHODIMP OnCachePayloadExtractComplete(
+        __in_z_opt LPCWSTR /*wzPackageOrContainerId*/,
+        __in_z_opt LPCWSTR /*wzPayloadId*/,
+        __in HRESULT /*hrStatus*/
+        )
+    {
+        return S_OK;
    }
 protected:
diff --git a/src/balutil/inc/BalBaseBootstrapperApplicationProc.h b/src/balutil/inc/BalBaseBootstrapperApplicationProc.h
index 42ffeb79..10769529 100644
--- a/src/balutil/inc/BalBaseBootstrapperApplicationProc.h
+++ b/src/balutil/inc/BalBaseBootstrapperApplicationProc.h
@@ -342,6 +342,15 @@ static HRESULT BalBaseBAProcOnCacheVerifyBegin(
    return pBA->OnCacheVerifyBegin(pArgs->wzPackageOrContainerId, pArgs->wzPayloadId, &pResults->fCancel);
 }
+static HRESULT BalBaseBAProcOnCacheVerifyProgress(
+    __in IBootstrapperApplication* pBA,
+    __in BA_ONCACHEVERIFYPROGRESS_ARGS* pArgs,
+    __inout BA_ONCACHEVERIFYPROGRESS_RESULTS* pResults
+    )
+{
+    return pBA->OnCacheVerifyProgress(pArgs->wzPackageOrContainerId, pArgs->wzPayloadId, pArgs->dw64Progress, pArgs->dw64Total, pArgs->dwOverallPercentage, pArgs->verifyStep, &pResults->fCancel);
+}
 static HRESULT BalBaseBAProcOnCacheVerifyComplete(
    __in IBootstrapperApplication* pBA,
    __in BA_ONCACHEVERIFYCOMPLETE_ARGS* pArgs,
@@ -594,6 +603,60 @@ static HRESULT BalBaseBAProcOnPlanForwardCompatibleBundle(
    return pBA->OnPlanForwardCompatibleBundle(pArgs->wzBundleId, pArgs->relationType, pArgs->wzBundleTag, pArgs->fPerMachine, pArgs->wzVersion, pArgs->fRecommendedIgnoreBundle, &pResults->fCancel, &pResults->fIgnoreBundle);
 }
+static HRESULT BalBaseBAProcOnCacheContainerOrPayloadVerifyBegin(
+    __in IBootstrapperApplication* pBA,
+    __in BA_ONCACHECONTAINERORPAYLOADVERIFYBEGIN_ARGS* pArgs,
+    __inout BA_ONCACHECONTAINERORPAYLOADVERIFYBEGIN_RESULTS* pResults
+    )
+{
+    return pBA->OnCacheContainerOrPayloadVerifyBegin(pArgs->wzPackageOrContainerId, pArgs->wzPayloadId, &pResults->fCancel);
+}
+static HRESULT BalBaseBAProcOnCacheContainerOrPayloadVerifyProgress(
+    __in IBootstrapperApplication* pBA,
+    __in BA_ONCACHECONTAINERORPAYLOADVERIFYPROGRESS_ARGS* pArgs,
+    __inout BA_ONCACHECONTAINERORPAYLOADVERIFYPROGRESS_RESULTS* pResults
+    )
+{
+    return pBA->OnCacheContainerOrPayloadVerifyProgress(pArgs->wzPackageOrContainerId, pArgs->wzPayloadId, pArgs->dw64Progress, pArgs->dw64Total, pArgs->dwOverallPercentage, &pResults->fCancel);
+}
+static HRESULT BalBaseBAProcOnCacheContainerOrPayloadVerifyComplete(
+    __in IBootstrapperApplication* pBA,
+    __in BA_ONCACHECONTAINERORPAYLOADVERIFYCOMPLETE_ARGS* pArgs,
+    __inout BA_ONCACHECONTAINERORPAYLOADVERIFYCOMPLETE_RESULTS* /*pResults*/
+    )
+{
+    return pBA->OnCacheContainerOrPayloadVerifyComplete(pArgs->wzPackageOrContainerId, pArgs->wzPayloadId, pArgs->hrStatus);
+}
+static HRESULT BalBaseBAProcOnCachePayloadExtractBegin(
+    __in IBootstrapperApplication* pBA,
+    __in BA_ONCACHEPAYLOADEXTRACTBEGIN_ARGS* pArgs,
+    __inout BA_ONCACHEPAYLOADEXTRACTBEGIN_RESULTS* pResults
+    )
+{
+    return pBA->OnCachePayloadExtractBegin(pArgs->wzContainerId, pArgs->wzPayloadId, &pResults->fCancel);
+}
+static HRESULT BalBaseBAProcOnCachePayloadExtractProgress(
+    __in IBootstrapperApplication* pBA,
+    __in BA_ONCACHEPAYLOADEXTRACTPROGRESS_ARGS* pArgs,
+    __inout BA_ONCACHEPAYLOADEXTRACTPROGRESS_RESULTS* pResults
+    )
+{
+    return pBA->OnCachePayloadExtractProgress(pArgs->wzContainerId, pArgs->wzPayloadId, pArgs->dw64Progress, pArgs->dw64Total, pArgs->dwOverallPercentage, &pResults->fCancel);
+}
+static HRESULT BalBaseBAProcOnCachePayloadExtractComplete(
+    __in IBootstrapperApplication* pBA,
+    __in BA_ONCACHEPAYLOADEXTRACTCOMPLETE_ARGS* pArgs,
+    __inout BA_ONCACHEPAYLOADEXTRACTCOMPLETE_RESULTS* /*pResults*/
+    )
+{
+    return pBA->OnCachePayloadExtractComplete(pArgs->wzContainerId, pArgs->wzPayloadId, pArgs->hrStatus);
+}
 /*******************************************************************
 BalBaseBootstrapperApplicationProc - requires pvContext to be of type IBootstrapperApplication.
                                     Provides a default mapping between the new message based BA interface and
@@ -722,6 +785,9 @@ static HRESULT WINAPI BalBaseBootstrapperApplicationProc(
        case BOOTSTRAPPER_APPLICATION_MESSAGE_ONCACHEVERIFYBEGIN:
            hr = BalBaseBAProcOnCacheVerifyBegin(pBA, reinterpret_cast<BA_ONCACHEVERIFYBEGIN_ARGS*>(pvArgs), reinterpret_cast<BA_ONCACHEVERIFYBEGIN_RESULTS*>(pvResults));
            break;
+        case BOOTSTRAPPER_APPLICATION_MESSAGE_ONCACHEVERIFYPROGRESS:
+            hr = BalBaseBAProcOnCacheVerifyProgress(pBA, reinterpret_cast<BA_ONCACHEVERIFYPROGRESS_ARGS*>(pvArgs), reinterpret_cast<BA_ONCACHEVERIFYPROGRESS_RESULTS*>(pvResults));
+            break;
        case BOOTSTRAPPER_APPLICATION_MESSAGE_ONCACHEVERIFYCOMPLETE:
            hr = BalBaseBAProcOnCacheVerifyComplete(pBA, reinterpret_cast<BA_ONCACHEVERIFYCOMPLETE_ARGS*>(pvArgs), reinterpret_cast<BA_ONCACHEVERIFYCOMPLETE_RESULTS*>(pvResults));
            break;
@@ -808,6 +874,24 @@ static HRESULT WINAPI BalBaseBootstrapperApplicationProc(
        case BOOTSTRAPPER_APPLICATION_MESSAGE_ONPLANFORWARDCOMPATIBLEBUNDLE:
            hr = BalBaseBAProcOnPlanForwardCompatibleBundle(pBA, reinterpret_cast<BA_ONPLANFORWARDCOMPATIBLEBUNDLE_ARGS*>(pvArgs), reinterpret_cast<BA_ONPLANFORWARDCOMPATIBLEBUNDLE_RESULTS*>(pvResults));
            break;
+        case BOOTSTRAPPER_APPLICATION_MESSAGE_ONCACHECONTAINERORPAYLOADVERIFYBEGIN:
+            hr = BalBaseBAProcOnCacheContainerOrPayloadVerifyBegin(pBA, reinterpret_cast<BA_ONCACHECONTAINERORPAYLOADVERIFYBEGIN_ARGS*>(pvArgs), reinterpret_cast<BA_ONCACHECONTAINERORPAYLOADVERIFYBEGIN_RESULTS*>(pvResults));
+            break;
+        case BOOTSTRAPPER_APPLICATION_MESSAGE_ONCACHECONTAINERORPAYLOADVERIFYPROGRESS:
+            hr = BalBaseBAProcOnCacheContainerOrPayloadVerifyProgress(pBA, reinterpret_cast<BA_ONCACHECONTAINERORPAYLOADVERIFYPROGRESS_ARGS*>(pvArgs), reinterpret_cast<BA_ONCACHECONTAINERORPAYLOADVERIFYPROGRESS_RESULTS*>(pvResults));
+            break;
+        case BOOTSTRAPPER_APPLICATION_MESSAGE_ONCACHECONTAINERORPAYLOADVERIFYCOMPLETE:
+            hr = BalBaseBAProcOnCacheContainerOrPayloadVerifyComplete(pBA, reinterpret_cast<BA_ONCACHECONTAINERORPAYLOADVERIFYCOMPLETE_ARGS*>(pvArgs), reinterpret_cast<BA_ONCACHECONTAINERORPAYLOADVERIFYCOMPLETE_RESULTS*>(pvResults));
+            break;
+        case BOOTSTRAPPER_APPLICATION_MESSAGE_ONCACHEPAYLOADEXTRACTBEGIN:
+            hr = BalBaseBAProcOnCachePayloadExtractBegin(pBA, reinterpret_cast<BA_ONCACHEPAYLOADEXTRACTBEGIN_ARGS*>(pvArgs), reinterpret_cast<BA_ONCACHEPAYLOADEXTRACTBEGIN_RESULTS*>(pvResults));
+            break;
+        case BOOTSTRAPPER_APPLICATION_MESSAGE_ONCACHEPAYLOADEXTRACTPROGRESS:
+            hr = BalBaseBAProcOnCachePayloadExtractProgress(pBA, reinterpret_cast<BA_ONCACHEPAYLOADEXTRACTPROGRESS_ARGS*>(pvArgs), reinterpret_cast<BA_ONCACHEPAYLOADEXTRACTPROGRESS_RESULTS*>(pvResults));
+            break;
+        case BOOTSTRAPPER_APPLICATION_MESSAGE_ONCACHEPAYLOADEXTRACTCOMPLETE:
+            hr = BalBaseBAProcOnCachePayloadExtractComplete(pBA, reinterpret_cast<BA_ONCACHEPAYLOADEXTRACTCOMPLETE_ARGS*>(pvArgs), reinterpret_cast<BA_ONCACHEPAYLOADEXTRACTCOMPLETE_RESULTS*>(pvResults));
+            break;
        }
    }
diff --git a/src/balutil/inc/IBootstrapperApplication.h b/src/balutil/inc/IBootstrapperApplication.h
index 8fcdd318..7d6a7164 100644
--- a/src/balutil/inc/IBootstrapperApplication.h
+++ b/src/balutil/inc/IBootstrapperApplication.h
@@ -4,6 +4,26 @@
 DECLARE_INTERFACE_IID_(IBootstrapperApplication, IUnknown, "53C31D56-49C0-426B-AB06-099D717C67FE")
 {
+    // BAProc - The PFN_BOOTSTRAPPER_APPLICATION_PROC can call this method to give the BA raw access to the callback from the engine.
+    //          This might be used to help the BA support more than one version of the engine.
+    STDMETHOD(BAProc)(
+        __in BOOTSTRAPPER_APPLICATION_MESSAGE message,
+        __in const LPVOID pvArgs,
+        __inout LPVOID pvResults,
+        __in_opt LPVOID pvContext
+        ) = 0;
+    // BAProcFallback - The PFN_BOOTSTRAPPER_APPLICATION_PROC can call this method
+    //                  to give the BA the ability to use default behavior
+    //                  and then forward the message to extensions.
+    STDMETHOD_(void, BAProcFallback)(
+        __in BOOTSTRAPPER_APPLICATION_MESSAGE message,
+        __in const LPVOID pvArgs,
+        __inout LPVOID pvResults,
+        __inout HRESULT* phr,
+        __in_opt LPVOID pvContext
+        ) = 0;
    // OnStartup - called when the engine is ready for the bootstrapper application to start.
    //
    STDMETHOD(OnStartup)() = 0;
@@ -297,8 +317,7 @@ DECLARE_INTERFACE_IID_(IBootstrapperApplication, IUnknown, "53C31D56-49C0-426B-A
        __inout BOOL* pfCancel
        ) = 0;
-    // OnCacheAcquireProgress - called when the engine makes progresss copying
+    // OnCacheAcquireProgress - called when the engine makes progress acquiring the payload or container.
-    //                          or downloading a payload to the working folder.
    //
    STDMETHOD(OnCacheAcquireProgress)(
        __in_z_opt LPCWSTR wzPackageOrContainerId,
@@ -359,6 +378,16 @@ DECLARE_INTERFACE_IID_(IBootstrapperApplication, IUnknown, "53C31D56-49C0-426B-A
        __inout BOOL* pfCancel
        ) = 0;
+    STDMETHOD(OnCacheVerifyProgress)(
+        __in_z_opt LPCWSTR wzPackageOrContainerId,
+        __in_z_opt LPCWSTR wzPayloadId,
+        __in DWORD64 dw64Progress,
+        __in DWORD64 dw64Total,
+        __in DWORD dwOverallPercentage,
+        __in BOOTSTRAPPER_CACHE_VERIFY_STEP verifyStep,
+        __inout BOOL* pfCancel
+        ) = 0;
    // OnCacheVerifyComplete - called after the engine verifies and copies
    //                         a payload or container to the package cache folder.
    //
@@ -570,23 +599,45 @@ DECLARE_INTERFACE_IID_(IBootstrapperApplication, IUnknown, "53C31D56-49C0-426B-A
        __inout BOOL* pfIgnoreBundle
        ) = 0;
-    // BAProc - The PFN_BOOTSTRAPPER_APPLICATION_PROC can call this method to give the BA raw access to the callback from the engine.
+    STDMETHOD(OnCacheContainerOrPayloadVerifyBegin)(
-    //          This might be used to help the BA support more than one version of the engine.
+        __in_z_opt LPCWSTR wzPackageOrContainerId,
-    STDMETHOD(BAProc)(
+        __in_z_opt LPCWSTR wzPayloadId,
-        __in BOOTSTRAPPER_APPLICATION_MESSAGE message,
+        __inout BOOL* pfCancel
-        __in const LPVOID pvArgs,
-        __inout LPVOID pvResults,
-        __in_opt LPVOID pvContext
        ) = 0;
-    // BAProcFallback - The PFN_BOOTSTRAPPER_APPLICATION_PROC can call this method
+    STDMETHOD(OnCacheContainerOrPayloadVerifyProgress)(
-    //                  to give the BA the ability to use default behavior
+        __in_z_opt LPCWSTR wzPackageOrContainerId,
-    //                  and then forward the message to extensions.
+        __in_z_opt LPCWSTR wzPayloadId,
-    STDMETHOD_(void, BAProcFallback)(
+        __in DWORD64 dw64Progress,
-        __in BOOTSTRAPPER_APPLICATION_MESSAGE message,
+        __in DWORD64 dw64Total,
-        __in const LPVOID pvArgs,
+        __in DWORD dwOverallPercentage,
-        __inout LPVOID pvResults,
+        __inout BOOL* pfCancel
-        __inout HRESULT* phr,
+        ) = 0;
-        __in_opt LPVOID pvContext
+    STDMETHOD(OnCacheContainerOrPayloadVerifyComplete)(
+        __in_z_opt LPCWSTR wzPackageOrContainerId,
+        __in_z_opt LPCWSTR wzPayloadId,
+        __in HRESULT hrStatus
+        ) = 0;
+    STDMETHOD(OnCachePayloadExtractBegin)(
+        __in_z_opt LPCWSTR wzContainerId,
+        __in_z_opt LPCWSTR wzPayloadId,
+        __inout BOOL* pfCancel
+        ) = 0;
+    STDMETHOD(OnCachePayloadExtractProgress)(
+        __in_z_opt LPCWSTR wzContainerId,
+        __in_z_opt LPCWSTR wzPayloadId,
+        __in DWORD64 dw64Progress,
+        __in DWORD64 dw64Total,
+        __in DWORD dwOverallPercentage,
+        __inout BOOL* pfCancel
+        ) = 0;
+    STDMETHOD(OnCachePayloadExtractComplete)(
+        __in_z_opt LPCWSTR wzContainerId,
+        __in_z_opt LPCWSTR wzPayloadId,
+        __in HRESULT hrStatus
        ) = 0;
 };
author	Sean Hall <r.sean.hall@gmail.com>	2021-04-19 17:35:44 -0500
committer	Sean Hall <r.sean.hall@gmail.com>	2021-04-19 23:23:39 -0500
commit	11fe2c881d182f9caff28bd9ff08c2e4fe513989 (patch)
tree	a2f1769b78e9b1eb4708678fe6b5374eec209c6a
parent	62b32cd6f21292c73dae8d5cfcd3a1cb13a1fd7d (diff)
download	wix-11fe2c881d182f9caff28bd9ff08c2e4fe513989.tar.gz wix-11fe2c881d182f9caff28bd9ff08c2e4fe513989.tar.bz2 wix-11fe2c881d182f9caff28bd9ff08c2e4fe513989.zip