1 files changed, 1054 insertions, 0 deletions

diff --git a/src/WixToolset.BootstrapperCore.Native/inc/BootstrapperApplication.h b/src/WixToolset.BootstrapperCore.Native/inc/BootstrapperApplication.h
new file mode 100644
index 00000000..36d788ca
--- /dev/null
+++ b/src/WixToolset.BootstrapperCore.Native/inc/BootstrapperApplication.h
@@ -0,0 +1,1054 @@
+#pragma once
+// Copyright (c) .NET Foundation and contributors. All rights reserved. Licensed under the Microsoft Reciprocal License. See LICENSE.TXT file in the project root for full license information.
+
+
+enum BOOTSTRAPPER_DISPLAY
+{
+    BOOTSTRAPPER_DISPLAY_UNKNOWN,
+    BOOTSTRAPPER_DISPLAY_EMBEDDED,
+    BOOTSTRAPPER_DISPLAY_NONE,
+    BOOTSTRAPPER_DISPLAY_PASSIVE,
+    BOOTSTRAPPER_DISPLAY_FULL,
+};
+
+enum BOOTSTRAPPER_RESTART
+{
+    BOOTSTRAPPER_RESTART_UNKNOWN,
+    BOOTSTRAPPER_RESTART_NEVER,
+    BOOTSTRAPPER_RESTART_PROMPT,
+    BOOTSTRAPPER_RESTART_AUTOMATIC,
+    BOOTSTRAPPER_RESTART_ALWAYS,
+};
+
+enum BOOTSTRAPPER_RESUME_TYPE
+{
+    BOOTSTRAPPER_RESUME_TYPE_NONE,
+    BOOTSTRAPPER_RESUME_TYPE_INVALID,        // resume information is present but invalid
+    BOOTSTRAPPER_RESUME_TYPE_INTERRUPTED,    // relaunched after an unexpected interruption
+    BOOTSTRAPPER_RESUME_TYPE_REBOOT_PENDING, // reboot has not taken place yet
+    BOOTSTRAPPER_RESUME_TYPE_REBOOT,         // relaunched after reboot
+    BOOTSTRAPPER_RESUME_TYPE_SUSPEND,        // relaunched after suspend
+    BOOTSTRAPPER_RESUME_TYPE_ARP,            // launched from ARP
+};
+
+enum BOOTSTRAPPER_ERROR_TYPE
+{
+    BOOTSTRAPPER_ERROR_TYPE_ELEVATE,            // error occurred trying to elevate.
+    BOOTSTRAPPER_ERROR_TYPE_WINDOWS_INSTALLER,  // error came from windows installer.
+    BOOTSTRAPPER_ERROR_TYPE_EXE_PACKAGE,        // error came from an exe package.
+    BOOTSTRAPPER_ERROR_TYPE_HTTP_AUTH_SERVER,   // error occurred trying to authenticate with HTTP server.
+    BOOTSTRAPPER_ERROR_TYPE_HTTP_AUTH_PROXY,    // error occurred trying to authenticate with HTTP proxy.
+    BOOTSTRAPPER_ERROR_TYPE_APPLY,              // error occurred during apply.
+};
+
+enum BOOTSTRAPPER_RELATED_OPERATION
+{
+    BOOTSTRAPPER_RELATED_OPERATION_NONE,
+    BOOTSTRAPPER_RELATED_OPERATION_DOWNGRADE,
+    BOOTSTRAPPER_RELATED_OPERATION_MINOR_UPDATE,
+    BOOTSTRAPPER_RELATED_OPERATION_MAJOR_UPGRADE,
+    BOOTSTRAPPER_RELATED_OPERATION_REMOVE,
+    BOOTSTRAPPER_RELATED_OPERATION_INSTALL,
+    BOOTSTRAPPER_RELATED_OPERATION_REPAIR,
+};
+
+enum BOOTSTRAPPER_CACHE_OPERATION
+{
+    BOOTSTRAPPER_CACHE_OPERATION_COPY,
+    BOOTSTRAPPER_CACHE_OPERATION_DOWNLOAD,
+    BOOTSTRAPPER_CACHE_OPERATION_EXTRACT,
+};
+
+enum BOOTSTRAPPER_APPLY_RESTART
+{
+    BOOTSTRAPPER_APPLY_RESTART_NONE,
+    BOOTSTRAPPER_APPLY_RESTART_REQUIRED,
+    BOOTSTRAPPER_APPLY_RESTART_INITIATED,
+};
+
+enum BOOTSTRAPPER_RELATION_TYPE
+{
+    BOOTSTRAPPER_RELATION_NONE,
+    BOOTSTRAPPER_RELATION_DETECT,
+    BOOTSTRAPPER_RELATION_UPGRADE,
+    BOOTSTRAPPER_RELATION_ADDON,
+    BOOTSTRAPPER_RELATION_PATCH,
+    BOOTSTRAPPER_RELATION_DEPENDENT,
+    BOOTSTRAPPER_RELATION_UPDATE,
+};
+
+enum BOOTSTRAPPER_APPLICATION_MESSAGE
+{
+    BOOTSTRAPPER_APPLICATION_MESSAGE_ONDETECTBEGIN,
+    BOOTSTRAPPER_APPLICATION_MESSAGE_ONDETECTCOMPLETE,
+    BOOTSTRAPPER_APPLICATION_MESSAGE_ONPLANBEGIN,
+    BOOTSTRAPPER_APPLICATION_MESSAGE_ONPLANCOMPLETE,
+    BOOTSTRAPPER_APPLICATION_MESSAGE_ONSTARTUP,
+    BOOTSTRAPPER_APPLICATION_MESSAGE_ONSHUTDOWN,
+    BOOTSTRAPPER_APPLICATION_MESSAGE_ONSYSTEMSHUTDOWN,
+    BOOTSTRAPPER_APPLICATION_MESSAGE_ONDETECTFORWARDCOMPATIBLEBUNDLE,
+    BOOTSTRAPPER_APPLICATION_MESSAGE_ONDETECTUPDATEBEGIN,
+    BOOTSTRAPPER_APPLICATION_MESSAGE_ONDETECTUPDATE,
+    BOOTSTRAPPER_APPLICATION_MESSAGE_ONDETECTUPDATECOMPLETE,
+    BOOTSTRAPPER_APPLICATION_MESSAGE_ONDETECTRELATEDBUNDLE,
+    BOOTSTRAPPER_APPLICATION_MESSAGE_ONDETECTPACKAGEBEGIN,
+    BOOTSTRAPPER_APPLICATION_MESSAGE_ONDETECTCOMPATIBLEMSIPACKAGE,
+    BOOTSTRAPPER_APPLICATION_MESSAGE_ONDETECTRELATEDMSIPACKAGE,
+    BOOTSTRAPPER_APPLICATION_MESSAGE_ONDETECTTARGETMSIPACKAGE,
+    BOOTSTRAPPER_APPLICATION_MESSAGE_ONDETECTMSIFEATURE,
+    BOOTSTRAPPER_APPLICATION_MESSAGE_ONDETECTPACKAGECOMPLETE,
+    BOOTSTRAPPER_APPLICATION_MESSAGE_ONPLANRELATEDBUNDLE,
+    BOOTSTRAPPER_APPLICATION_MESSAGE_ONPLANPACKAGEBEGIN,
+    BOOTSTRAPPER_APPLICATION_MESSAGE_ONPLANCOMPATIBLEMSIPACKAGEBEGIN,
+    BOOTSTRAPPER_APPLICATION_MESSAGE_ONPLANCOMPATIBLEMSIPACKAGECOMPLETE,
+    BOOTSTRAPPER_APPLICATION_MESSAGE_ONPLANTARGETMSIPACKAGE,
+    BOOTSTRAPPER_APPLICATION_MESSAGE_ONPLANMSIFEATURE,
+    BOOTSTRAPPER_APPLICATION_MESSAGE_ONPLANPACKAGECOMPLETE,
+    BOOTSTRAPPER_APPLICATION_MESSAGE_ONAPPLYBEGIN,
+    BOOTSTRAPPER_APPLICATION_MESSAGE_ONELEVATEBEGIN,
+    BOOTSTRAPPER_APPLICATION_MESSAGE_ONELEVATECOMPLETE,
+    BOOTSTRAPPER_APPLICATION_MESSAGE_ONPROGRESS,
+    BOOTSTRAPPER_APPLICATION_MESSAGE_ONERROR,
+    BOOTSTRAPPER_APPLICATION_MESSAGE_ONREGISTERBEGIN,
+    BOOTSTRAPPER_APPLICATION_MESSAGE_ONREGISTERCOMPLETE,
+    BOOTSTRAPPER_APPLICATION_MESSAGE_ONCACHEBEGIN,
+    BOOTSTRAPPER_APPLICATION_MESSAGE_ONCACHEPACKAGEBEGIN,
+    BOOTSTRAPPER_APPLICATION_MESSAGE_ONCACHEACQUIREBEGIN,
+    BOOTSTRAPPER_APPLICATION_MESSAGE_ONCACHEACQUIREPROGRESS,
+    BOOTSTRAPPER_APPLICATION_MESSAGE_ONRESOLVESOURCE,
+    BOOTSTRAPPER_APPLICATION_MESSAGE_ONCACHEACQUIRECOMPLETE,
+    BOOTSTRAPPER_APPLICATION_MESSAGE_ONCACHEVERIFYBEGIN,
+    BOOTSTRAPPER_APPLICATION_MESSAGE_ONCACHEVERIFYCOMPLETE,
+    BOOTSTRAPPER_APPLICATION_MESSAGE_ONCACHEPACKAGECOMPLETE,
+    BOOTSTRAPPER_APPLICATION_MESSAGE_ONCACHECOMPLETE,
+    BOOTSTRAPPER_APPLICATION_MESSAGE_ONEXECUTEBEGIN,
+    BOOTSTRAPPER_APPLICATION_MESSAGE_ONEXECUTEPACKAGEBEGIN,
+    BOOTSTRAPPER_APPLICATION_MESSAGE_ONEXECUTEPATCHTARGET,
+    BOOTSTRAPPER_APPLICATION_MESSAGE_ONEXECUTEPROGRESS,
+    BOOTSTRAPPER_APPLICATION_MESSAGE_ONEXECUTEMSIMESSAGE,
+    BOOTSTRAPPER_APPLICATION_MESSAGE_ONEXECUTEFILESINUSE,
+    BOOTSTRAPPER_APPLICATION_MESSAGE_ONEXECUTEPACKAGECOMPLETE,
+    BOOTSTRAPPER_APPLICATION_MESSAGE_ONEXECUTECOMPLETE,
+    BOOTSTRAPPER_APPLICATION_MESSAGE_ONUNREGISTERBEGIN,
+    BOOTSTRAPPER_APPLICATION_MESSAGE_ONUNREGISTERCOMPLETE,
+    BOOTSTRAPPER_APPLICATION_MESSAGE_ONAPPLYCOMPLETE,
+    BOOTSTRAPPER_APPLICATION_MESSAGE_ONLAUNCHAPPROVEDEXEBEGIN,
+    BOOTSTRAPPER_APPLICATION_MESSAGE_ONLAUNCHAPPROVEDEXECOMPLETE,
+    BOOTSTRAPPER_APPLICATION_MESSAGE_ONPLANMSIPACKAGE,
+};
+
+enum BOOTSTRAPPER_APPLYCOMPLETE_ACTION
+{
+    BOOTSTRAPPER_APPLYCOMPLETE_ACTION_NONE,
+    // Instructs the engine to restart.
+    // The engine will not launch again after the machine is rebooted.
+    // Ignored if reboot was already initiated by OnExecutePackageComplete().
+    BOOTSTRAPPER_APPLYCOMPLETE_ACTION_RESTART,
+};
+
+enum BOOTSTRAPPER_CACHEACQUIRECOMPLETE_ACTION
+{
+    BOOTSTRAPPER_CACHEACQUIRECOMPLETE_ACTION_NONE,
+    // Instructs the engine to try the acquisition of the package again.
+    // Ignored if hrStatus is a success.
+    BOOTSTRAPPER_CACHEACQUIRECOMPLETE_ACTION_RETRY,
+};
+
+enum BOOTSTRAPPER_CACHEPACKAGECOMPLETE_ACTION
+{
+    BOOTSTRAPPER_CACHEPACKAGECOMPLETE_ACTION_NONE,
+    // Instructs the engine to ignore non-vital package failures and
+    // continue with the caching.
+    // Ignored if hrStatus is a success or the package is vital.
+    BOOTSTRAPPER_CACHEPACKAGECOMPLETE_ACTION_IGNORE,
+    // Instructs the engine to try the acquisition and verification of the package again.
+    // Ignored if hrStatus is a success.
+    BOOTSTRAPPER_CACHEPACKAGECOMPLETE_ACTION_RETRY,
+};
+
+enum BOOTSTRAPPER_CACHEVERIFYCOMPLETE_ACTION
+{
+    BOOTSTRAPPER_CACHEVERIFYCOMPLETE_ACTION_NONE,
+    // Ignored if hrStatus is a success.
+    BOOTSTRAPPER_CACHEVERIFYCOMPLETE_ACTION_RETRYVERIFICATION,
+    // Ignored if hrStatus is a success.
+    BOOTSTRAPPER_CACHEVERIFYCOMPLETE_ACTION_RETRYACQUISITION,
+};
+
+enum BOOTSTRAPPER_EXECUTEPACKAGECOMPLETE_ACTION
+{
+    BOOTSTRAPPER_EXECUTEPACKAGECOMPLETE_ACTION_NONE,
+    // Instructs the engine to ignore non-vital package failures and
+    // continue with the install.
+    // Ignored if hrStatus is a success or the package is vital.
+    BOOTSTRAPPER_EXECUTEPACKAGECOMPLETE_ACTION_IGNORE,
+    // Instructs the engine to try the execution of the package again.
+    // Ignored if hrStatus is a success.
+    BOOTSTRAPPER_EXECUTEPACKAGECOMPLETE_ACTION_RETRY,
+    // Instructs the engine to stop processing the chain and restart.
+    // The engine will launch again after the machine is restarted.
+    BOOTSTRAPPER_EXECUTEPACKAGECOMPLETE_ACTION_RESTART,
+    // Instructs the engine to stop processing the chain and
+    // suspend the current state.
+    BOOTSTRAPPER_EXECUTEPACKAGECOMPLETE_ACTION_SUSPEND,
+};
+
+enum BOOTSTRAPPER_RESOLVESOURCE_ACTION
+{
+    // Instructs the engine that the source can't be found.
+    BOOTSTRAPPER_RESOLVESOURCE_ACTION_NONE,
+    // Instructs the engine to try the local source again.
+    BOOTSTRAPPER_RESOLVESOURCE_ACTION_RETRY,
+    // Instructs the engine to try the download source.
+    BOOTSTRAPPER_RESOLVESOURCE_ACTION_DOWNLOAD,
+};
+
+enum BOOTSTRAPPER_SHUTDOWN_ACTION
+{
+    BOOTSTRAPPER_SHUTDOWN_ACTION_NONE,
+    // Instructs the engine to restart.
+    // The engine will not launch again after the machine is rebooted.
+    // Ignored if reboot was already initiated by OnExecutePackageComplete().
+    BOOTSTRAPPER_SHUTDOWN_ACTION_RESTART,
+    // Instructs the engine to unload the bootstrapper application and
+    // restart the engine which will load the bootstrapper application again.
+    // Typically used to switch from a native bootstrapper application to a managed one.
+    BOOTSTRAPPER_SHUTDOWN_ACTION_RELOAD_BOOTSTRAPPER,
+};
+
+enum BURN_MSI_PROPERTY
+{
+    BURN_MSI_PROPERTY_NONE,     // no property added
+    BURN_MSI_PROPERTY_INSTALL,  // add BURNMSIINSTALL=1
+    BURN_MSI_PROPERTY_MODIFY,   // add BURNMSIMODIFY=1
+    BURN_MSI_PROPERTY_REPAIR,   // add BURNMSIREPAIR=1
+    BURN_MSI_PROPERTY_UNINSTALL,// add BURNMSIUNINSTALL=1
+};
+
+struct BOOTSTRAPPER_COMMAND
+{
+    DWORD cbSize;
+    BOOTSTRAPPER_ACTION action;
+    BOOTSTRAPPER_DISPLAY display;
+    BOOTSTRAPPER_RESTART restart;
+
+    LPWSTR wzCommandLine;
+    int nCmdShow;
+
+    BOOTSTRAPPER_RESUME_TYPE resumeType;
+    HWND hwndSplashScreen;
+
+    // If this was run from a related bundle, specifies the relation type
+    BOOTSTRAPPER_RELATION_TYPE relationType;
+    BOOL fPassthrough;
+
+    LPWSTR wzLayoutDirectory;
+    LPWSTR wzBootstrapperWorkingFolder;
+    LPWSTR wzBootstrapperApplicationDataPath;
+};
+
+struct BA_ONAPPLYBEGIN_ARGS
+{
+    DWORD cbSize;
+    DWORD dwPhaseCount;
+};
+
+struct BA_ONAPPLYBEGIN_RESULTS
+{
+    DWORD cbSize;
+    BOOL fCancel;
+};
+
+struct BA_ONAPPLYCOMPLETE_ARGS
+{
+    DWORD cbSize;
+    HRESULT hrStatus;
+    // Indicates whether any package required a reboot or initiated the reboot already.
+    BOOTSTRAPPER_APPLY_RESTART restart;
+    BOOTSTRAPPER_APPLYCOMPLETE_ACTION recommendation;
+};
+
+struct BA_ONAPPLYCOMPLETE_RESULTS
+{
+    DWORD cbSize;
+    BOOTSTRAPPER_APPLYCOMPLETE_ACTION action;
+};
+
+struct BA_ONCACHEACQUIREBEGIN_ARGS
+{
+    DWORD cbSize;
+    LPCWSTR wzPackageOrContainerId;
+    LPCWSTR wzPayloadId;
+    BOOTSTRAPPER_CACHE_OPERATION operation;
+    LPCWSTR wzSource;
+};
+
+struct BA_ONCACHEACQUIREBEGIN_RESULTS
+{
+    DWORD cbSize;
+    BOOL fCancel;
+};
+
+struct BA_ONCACHEACQUIRECOMPLETE_ARGS
+{
+    DWORD cbSize;
+    LPCWSTR wzPackageOrContainerId;
+    LPCWSTR wzPayloadId;
+    HRESULT hrStatus;
+    BOOTSTRAPPER_CACHEACQUIRECOMPLETE_ACTION recommendation;
+};
+
+struct BA_ONCACHEACQUIRECOMPLETE_RESULTS
+{
+    DWORD cbSize;
+    BOOTSTRAPPER_CACHEACQUIRECOMPLETE_ACTION action;
+};
+
+struct BA_ONCACHEACQUIREPROGRESS_ARGS
+{
+    DWORD cbSize;
+    LPCWSTR wzPackageOrContainerId;
+    LPCWSTR wzPayloadId;
+    DWORD64 dw64Progress;
+    DWORD64 dw64Total;
+    DWORD dwOverallPercentage;
+};
+
+struct BA_ONCACHEACQUIREPROGRESS_RESULTS
+{
+    DWORD cbSize;
+    BOOL fCancel;
+};
+
+struct BA_ONCACHEBEGIN_ARGS
+{
+    DWORD cbSize;
+};
+
+struct BA_ONCACHEBEGIN_RESULTS
+{
+    DWORD cbSize;
+    BOOL fCancel;
+};
+
+struct BA_ONCACHECOMPLETE_ARGS
+{
+    DWORD cbSize;
+    HRESULT hrStatus;
+};
+
+struct BA_ONCACHECOMPLETE_RESULTS
+{
+    DWORD cbSize;
+};
+
+struct BA_ONCACHEPACKAGEBEGIN_ARGS
+{
+    DWORD cbSize;
+    LPCWSTR wzPackageId;
+    DWORD cCachePayloads;
+    DWORD64 dw64PackageCacheSize;
+};
+
+struct BA_ONCACHEPACKAGEBEGIN_RESULTS
+{
+    DWORD cbSize;
+    BOOL fCancel;
+};
+
+struct BA_ONCACHEPACKAGECOMPLETE_ARGS
+{
+    DWORD cbSize;
+    LPCWSTR wzPackageId;
+    HRESULT hrStatus;
+    BOOTSTRAPPER_CACHEPACKAGECOMPLETE_ACTION recommendation;
+};
+
+struct BA_ONCACHEPACKAGECOMPLETE_RESULTS
+{
+    DWORD cbSize;
+    BOOTSTRAPPER_CACHEPACKAGECOMPLETE_ACTION action;
+};
+
+struct BA_ONCACHEVERIFYBEGIN_ARGS
+{
+    DWORD cbSize;
+    LPCWSTR wzPackageOrContainerId;
+    LPCWSTR wzPayloadId;
+};
+
+struct BA_ONCACHEVERIFYBEGIN_RESULTS
+{
+    DWORD cbSize;
+    BOOL fCancel;
+};
+
+struct BA_ONCACHEVERIFYCOMPLETE_ARGS
+{
+    DWORD cbSize;
+    LPCWSTR wzPackageOrContainerId;
+    LPCWSTR wzPayloadId;
+    HRESULT hrStatus;
+    BOOTSTRAPPER_CACHEVERIFYCOMPLETE_ACTION recommendation;
+};
+
+struct BA_ONCACHEVERIFYCOMPLETE_RESULTS
+{
+    DWORD cbSize;
+    BOOTSTRAPPER_CACHEVERIFYCOMPLETE_ACTION action;
+};
+
+struct BA_ONDETECTBEGIN_ARGS
+{
+    DWORD cbSize;
+    BOOL fInstalled;
+    DWORD cPackages;
+};
+
+struct BA_ONDETECTBEGIN_RESULTS
+{
+    DWORD cbSize;
+    BOOL fCancel;
+};
+
+struct BA_ONDETECTCOMPATIBLEMSIPACKAGE_ARGS
+{
+    DWORD cbSize;
+    LPCWSTR wzPackageId;
+    LPCWSTR wzCompatiblePackageId;
+    DWORD64 dw64CompatiblePackageVersion;
+};
+
+struct BA_ONDETECTCOMPATIBLEMSIPACKAGE_RESULTS
+{
+    DWORD cbSize;
+    BOOL fCancel;
+};
+
+struct BA_ONDETECTCOMPLETE_ARGS
+{
+    DWORD cbSize;
+    HRESULT hrStatus;
+};
+
+struct BA_ONDETECTCOMPLETE_RESULTS
+{
+    DWORD cbSize;
+};
+
+struct BA_ONDETECTFORWARDCOMPATIBLEBUNDLE_ARGS
+{
+    DWORD cbSize;
+    LPCWSTR wzBundleId;
+    BOOTSTRAPPER_RELATION_TYPE relationType;
+    LPCWSTR wzBundleTag;
+    BOOL fPerMachine;
+    DWORD64 dw64Version;
+};
+
+struct BA_ONDETECTFORWARDCOMPATIBLEBUNDLE_RESULTS
+{
+    DWORD cbSize;
+    BOOL fCancel;
+    BOOL fIgnoreBundle;
+};
+
+struct BA_ONDETECTMSIFEATURE_ARGS
+{
+    DWORD cbSize;
+    LPCWSTR wzPackageId;
+    LPCWSTR wzFeatureId;
+    BOOTSTRAPPER_FEATURE_STATE state;
+};
+
+struct BA_ONDETECTMSIFEATURE_RESULTS
+{
+    DWORD cbSize;
+    BOOL fCancel;
+};
+
+struct BA_ONDETECTPACKAGEBEGIN_ARGS
+{
+    DWORD cbSize;
+    LPCWSTR wzPackageId;
+};
+
+struct BA_ONDETECTPACKAGEBEGIN_RESULTS
+{
+    DWORD cbSize;
+    BOOL fCancel;
+};
+
+struct BA_ONDETECTPACKAGECOMPLETE_ARGS
+{
+    DWORD cbSize;
+    LPCWSTR wzPackageId;
+    HRESULT hrStatus;
+    BOOTSTRAPPER_PACKAGE_STATE state;
+};
+
+struct BA_ONDETECTPACKAGECOMPLETE_RESULTS
+{
+    DWORD cbSize;
+};
+
+struct BA_ONDETECTRELATEDBUNDLE_ARGS
+{
+    DWORD cbSize;
+    LPCWSTR wzBundleId;
+    BOOTSTRAPPER_RELATION_TYPE relationType;
+    LPCWSTR wzBundleTag;
+    BOOL fPerMachine;
+    DWORD64 dw64Version;
+    BOOTSTRAPPER_RELATED_OPERATION operation;
+};
+
+struct BA_ONDETECTRELATEDBUNDLE_RESULTS
+{
+    DWORD cbSize;
+    BOOL fCancel;
+};
+
+struct BA_ONDETECTRELATEDMSIPACKAGE_ARGS
+{
+    DWORD cbSize;
+    LPCWSTR wzPackageId;
+    LPCWSTR wzUpgradeCode;
+    LPCWSTR wzProductCode;
+    BOOL fPerMachine;
+    DWORD64 dw64Version;
+    BOOTSTRAPPER_RELATED_OPERATION operation;
+};
+
+struct BA_ONDETECTRELATEDMSIPACKAGE_RESULTS
+{
+    DWORD cbSize;
+    BOOL fCancel;
+};
+
+struct BA_ONDETECTTARGETMSIPACKAGE_ARGS
+{
+    DWORD cbSize;
+    LPCWSTR wzPackageId;
+    LPCWSTR wzProductCode;
+    BOOTSTRAPPER_PACKAGE_STATE patchState;
+};
+
+struct BA_ONDETECTTARGETMSIPACKAGE_RESULTS
+{
+    DWORD cbSize;
+    BOOL fCancel;
+};
+
+struct BA_ONDETECTUPDATE_ARGS
+{
+    DWORD cbSize;
+    LPCWSTR wzUpdateLocation;
+    DWORD64 dw64Size;
+    DWORD64 dw64Version;
+    LPCWSTR wzTitle;
+    LPCWSTR wzSummary;
+    LPCWSTR wzContentType;
+    LPCWSTR wzContent;
+};
+
+struct BA_ONDETECTUPDATE_RESULTS
+{
+    DWORD cbSize;
+    BOOL fCancel;
+    BOOL fStopProcessingUpdates;
+};
+
+struct BA_ONDETECTUPDATEBEGIN_ARGS
+{
+    DWORD cbSize;
+    LPCWSTR wzUpdateLocation;
+};
+
+struct BA_ONDETECTUPDATEBEGIN_RESULTS
+{
+    DWORD cbSize;
+    BOOL fCancel;
+    BOOL fSkip;
+};
+
+struct BA_ONDETECTUPDATECOMPLETE_ARGS
+{
+    DWORD cbSize;
+    HRESULT hrStatus;
+};
+
+struct BA_ONDETECTUPDATECOMPLETE_RESULTS
+{
+    DWORD cbSize;
+    BOOL fIgnoreError;
+};
+
+struct BA_ONELEVATEBEGIN_ARGS
+{
+    DWORD cbSize;
+};
+
+struct BA_ONELEVATEBEGIN_RESULTS
+{
+    DWORD cbSize;
+    BOOL fCancel;
+};
+
+struct BA_ONELEVATECOMPLETE_ARGS
+{
+    DWORD cbSize;
+    HRESULT hrStatus;
+};
+
+struct BA_ONELEVATECOMPLETE_RESULTS
+{
+    DWORD cbSize;
+};
+
+struct BA_ONERROR_ARGS
+{
+    DWORD cbSize;
+    BOOTSTRAPPER_ERROR_TYPE errorType;
+    LPCWSTR wzPackageId;
+    DWORD dwCode;
+    LPCWSTR wzError;
+    DWORD dwUIHint;
+    DWORD cData;
+    LPCWSTR* rgwzData;
+    int nRecommendation;
+};
+
+struct BA_ONERROR_RESULTS
+{
+    DWORD cbSize;
+    int nResult;
+};
+
+struct BA_ONEXECUTEBEGIN_ARGS
+{
+    DWORD cbSize;
+    DWORD cExecutingPackages;
+};
+
+struct BA_ONEXECUTEBEGIN_RESULTS
+{
+    DWORD cbSize;
+    BOOL fCancel;
+};
+
+struct BA_ONEXECUTECOMPLETE_ARGS
+{
+    DWORD cbSize;
+    HRESULT hrStatus;
+};
+
+struct BA_ONEXECUTECOMPLETE_RESULTS
+{
+    DWORD cbSize;
+};
+
+struct BA_ONEXECUTEFILESINUSE_ARGS
+{
+    DWORD cbSize;
+    LPCWSTR wzPackageId;
+    DWORD cFiles;
+    LPCWSTR* rgwzFiles;
+    int nRecommendation;
+};
+
+struct BA_ONEXECUTEFILESINUSE_RESULTS
+{
+    DWORD cbSize;
+    int nResult;
+};
+
+struct BA_ONEXECUTEMSIMESSAGE_ARGS
+{
+    DWORD cbSize;
+    LPCWSTR wzPackageId;
+    INSTALLMESSAGE messageType;
+    DWORD dwUIHint;
+    LPCWSTR wzMessage;
+    DWORD cData;
+    LPCWSTR* rgwzData;
+    int nRecommendation;
+};
+
+struct BA_ONEXECUTEMSIMESSAGE_RESULTS
+{
+    DWORD cbSize;
+    int nResult;
+};
+
+struct BA_ONEXECUTEPACKAGEBEGIN_ARGS
+{
+    DWORD cbSize;
+    LPCWSTR wzPackageId;
+    BOOL fExecute; // false means rollback.
+    BOOTSTRAPPER_ACTION_STATE action;
+    INSTALLUILEVEL uiLevel;
+    BOOL fDisableExternalUiHandler;
+};
+
+struct BA_ONEXECUTEPACKAGEBEGIN_RESULTS
+{
+    DWORD cbSize;
+    BOOL fCancel;
+};
+
+struct BA_ONEXECUTEPACKAGECOMPLETE_ARGS
+{
+    DWORD cbSize;
+    LPCWSTR wzPackageId;
+    HRESULT hrStatus;
+    // Indicates whether this package requires a reboot or initiated the reboot already.
+    BOOTSTRAPPER_APPLY_RESTART restart;
+    BOOTSTRAPPER_EXECUTEPACKAGECOMPLETE_ACTION recommendation;
+};
+
+struct BA_ONEXECUTEPACKAGECOMPLETE_RESULTS
+{
+    DWORD cbSize;
+    BOOTSTRAPPER_EXECUTEPACKAGECOMPLETE_ACTION action;
+};
+
+struct BA_ONEXECUTEPATCHTARGET_ARGS
+{
+    DWORD cbSize;
+    LPCWSTR wzPackageId;
+    LPCWSTR wzTargetProductCode;
+};
+
+struct BA_ONEXECUTEPATCHTARGET_RESULTS
+{
+    DWORD cbSize;
+    BOOL fCancel;
+};
+
+struct BA_ONEXECUTEPROGRESS_ARGS
+{
+    DWORD cbSize;
+    LPCWSTR wzPackageId;
+    DWORD dwProgressPercentage;
+    DWORD dwOverallPercentage;
+};
+
+struct BA_ONEXECUTEPROGRESS_RESULTS
+{
+    DWORD cbSize;
+    BOOL fCancel;
+};
+
+struct BA_ONLAUNCHAPPROVEDEXEBEGIN_ARGS
+{
+    DWORD cbSize;
+};
+
+struct BA_ONLAUNCHAPPROVEDEXEBEGIN_RESULTS
+{
+    DWORD cbSize;
+    BOOL fCancel;
+};
+
+struct BA_ONLAUNCHAPPROVEDEXECOMPLETE_ARGS
+{
+    DWORD cbSize;
+    HRESULT hrStatus;
+    // Only valid if the operation succeeded.
+    DWORD dwProcessId;
+};
+
+struct BA_ONLAUNCHAPPROVEDEXECOMPLETE_RESULTS
+{
+    DWORD cbSize;
+};
+
+struct BA_ONPLANBEGIN_ARGS
+{
+    DWORD cbSize;
+    DWORD cPackages;
+};
+
+struct BA_ONPLANBEGIN_RESULTS
+{
+    DWORD cbSize;
+    BOOL fCancel;
+};
+
+struct BA_ONPLANCOMPATIBLEMSIPACKAGEBEGIN_ARGS
+{
+    DWORD cbSize;
+    LPCWSTR wzPackageId;
+    LPCWSTR wzCompatiblePackageId;
+    DWORD64 dw64CompatiblePackageVersion;
+    BOOTSTRAPPER_REQUEST_STATE recommendedState;
+};
+
+struct BA_ONPLANCOMPATIBLEMSIPACKAGEBEGIN_RESULTS
+{
+    DWORD cbSize;
+    BOOL fCancel;
+    BOOTSTRAPPER_REQUEST_STATE requestedState;
+};
+
+struct BA_ONPLANCOMPATIBLEMSIPACKAGECOMPLETE_ARGS
+{
+    DWORD cbSize;
+    LPCWSTR wzPackageId;
+    LPCWSTR wzCompatiblePackageId;
+    HRESULT hrStatus;
+    BOOTSTRAPPER_PACKAGE_STATE state;
+    BOOTSTRAPPER_REQUEST_STATE requested;
+    BOOTSTRAPPER_ACTION_STATE execute;
+    BOOTSTRAPPER_ACTION_STATE rollback;
+};
+
+struct BA_ONPLANCOMPATIBLEMSIPACKAGECOMPLETE_RESULTS
+{
+    DWORD cbSize;
+};
+
+struct BA_ONPLANCOMPLETE_ARGS
+{
+    DWORD cbSize;
+    HRESULT hrStatus;
+};
+
+struct BA_ONPLANCOMPLETE_RESULTS
+{
+    DWORD cbSize;
+};
+
+struct BA_ONPLANMSIFEATURE_ARGS
+{
+    DWORD cbSize;
+    LPCWSTR wzPackageId;
+    LPCWSTR wzFeatureId;
+    BOOTSTRAPPER_FEATURE_STATE recommendedState;
+};
+
+struct BA_ONPLANMSIFEATURE_RESULTS
+{
+    DWORD cbSize;
+    BOOTSTRAPPER_FEATURE_STATE requestedState;
+    BOOL fCancel;
+};
+
+struct BA_ONPLANMSIPACKAGE_ARGS
+{
+    DWORD cbSize;
+    LPCWSTR wzPackageId;
+    BOOL fExecute; // false means rollback.
+    BOOTSTRAPPER_ACTION_STATE action;
+};
+
+struct BA_ONPLANMSIPACKAGE_RESULTS
+{
+    DWORD cbSize;
+    BOOL fCancel;
+    BURN_MSI_PROPERTY actionMsiProperty;
+    INSTALLUILEVEL uiLevel;
+    BOOL fDisableExternalUiHandler;
+};
+
+struct BA_ONPLANPACKAGEBEGIN_ARGS
+{
+    DWORD cbSize;
+    LPCWSTR wzPackageId;
+    BOOTSTRAPPER_REQUEST_STATE recommendedState;
+};
+
+struct BA_ONPLANPACKAGEBEGIN_RESULTS
+{
+    DWORD cbSize;
+    BOOL fCancel;
+    BOOTSTRAPPER_REQUEST_STATE requestedState;
+};
+
+struct BA_ONPLANPACKAGECOMPLETE_ARGS
+{
+    DWORD cbSize;
+    LPCWSTR wzPackageId;
+    HRESULT hrStatus;
+    BOOTSTRAPPER_PACKAGE_STATE state;
+    BOOTSTRAPPER_REQUEST_STATE requested;
+    BOOTSTRAPPER_ACTION_STATE execute;
+    BOOTSTRAPPER_ACTION_STATE rollback;
+};
+
+struct BA_ONPLANPACKAGECOMPLETE_RESULTS
+{
+    DWORD cbSize;
+};
+
+struct BA_ONPLANRELATEDBUNDLE_ARGS
+{
+    DWORD cbSize;
+    LPCWSTR wzBundleId;
+    BOOTSTRAPPER_REQUEST_STATE recommendedState;
+};
+
+struct BA_ONPLANRELATEDBUNDLE_RESULTS
+{
+    DWORD cbSize;
+    BOOL fCancel;
+    BOOTSTRAPPER_REQUEST_STATE requestedState;
+};
+
+struct BA_ONPLANTARGETMSIPACKAGE_ARGS
+{
+    DWORD cbSize;
+    LPCWSTR wzPackageId;
+    LPCWSTR wzProductCode;
+    BOOTSTRAPPER_REQUEST_STATE recommendedState;
+};
+
+struct BA_ONPLANTARGETMSIPACKAGE_RESULTS
+{
+    DWORD cbSize;
+    BOOTSTRAPPER_REQUEST_STATE requestedState;
+    BOOL fCancel;
+};
+
+struct BA_ONPROGRESS_ARGS
+{
+    DWORD cbSize;
+    DWORD dwProgressPercentage;
+    DWORD dwOverallPercentage;
+};
+
+struct BA_ONPROGRESS_RESULTS
+{
+    DWORD cbSize;
+    BOOL fCancel;
+};
+
+struct BA_ONREGISTERBEGIN_ARGS
+{
+    DWORD cbSize;
+};
+
+struct BA_ONREGISTERBEGIN_RESULTS
+{
+    DWORD cbSize;
+    BOOL fCancel;
+};
+
+struct BA_ONREGISTERCOMPLETE_ARGS
+{
+    DWORD cbSize;
+    HRESULT hrStatus;
+};
+
+struct BA_ONREGISTERCOMPLETE_RESULTS
+{
+    DWORD cbSize;
+};
+
+struct BA_ONRESOLVESOURCE_ARGS
+{
+    DWORD cbSize;
+    LPCWSTR wzPackageOrContainerId;
+    LPCWSTR wzPayloadId;
+    LPCWSTR wzLocalSource;
+    LPCWSTR wzDownloadSource;
+    BOOTSTRAPPER_RESOLVESOURCE_ACTION recommendation;
+};
+
+struct BA_ONRESOLVESOURCE_RESULTS
+{
+    DWORD cbSize;
+    BOOTSTRAPPER_RESOLVESOURCE_ACTION action;
+    BOOL fCancel;
+};
+
+struct BA_ONSHUTDOWN_ARGS
+{
+    DWORD cbSize;
+};
+
+struct BA_ONSHUTDOWN_RESULTS
+{
+    DWORD cbSize;
+    BOOTSTRAPPER_SHUTDOWN_ACTION action;
+};
+
+struct BA_ONSTARTUP_ARGS
+{
+    DWORD cbSize;
+};
+
+struct BA_ONSTARTUP_RESULTS
+{
+    DWORD cbSize;
+};
+
+struct BA_ONSYSTEMSHUTDOWN_ARGS
+{
+    DWORD cbSize;
+    DWORD dwEndSession;
+};
+
+struct BA_ONSYSTEMSHUTDOWN_RESULTS
+{
+    DWORD cbSize;
+    BOOL fCancel;
+};
+
+struct BA_ONUNREGISTERBEGIN_ARGS
+{
+    DWORD cbSize;
+};
+
+struct BA_ONUNREGISTERBEGIN_RESULTS
+{
+    DWORD cbSize;
+    BOOL fCancel;
+};
+
+struct BA_ONUNREGISTERCOMPLETE_ARGS
+{
+    DWORD cbSize;
+    HRESULT hrStatus;
+};
+
+struct BA_ONUNREGISTERCOMPLETE_RESULTS
+{
+    DWORD cbSize;
+};
+
+
+
+extern "C" typedef HRESULT(WINAPI *PFN_BOOTSTRAPPER_APPLICATION_PROC)(
+    __in BOOTSTRAPPER_APPLICATION_MESSAGE message,
+    __in const LPVOID pvArgs,
+    __inout LPVOID pvResults,
+    __in_opt LPVOID pvContext
+    );
+
+extern "C" typedef void (WINAPI *PFN_BOOTSTRAPPER_APPLICATION_DESTROY)();
+
+
+
+struct BOOTSTRAPPER_CREATE_ARGS
+{
+    DWORD cbSize;
+    DWORD64 qwEngineAPIVersion;
+    PFN_BOOTSTRAPPER_ENGINE_PROC pfnBootstrapperEngineProc;
+    LPVOID pvBootstrapperEngineProcContext;
+    BOOTSTRAPPER_COMMAND* pCommand;
+};
+
+struct BOOTSTRAPPER_CREATE_RESULTS
+{
+    DWORD cbSize;
+    PFN_BOOTSTRAPPER_APPLICATION_PROC pfnBootstrapperApplicationProc;
+    LPVOID pvBootstrapperApplicationProcContext;
+    BOOL fDisableUnloading; // indicates the BA dll must not be unloaded after BootstrapperApplicationDestroy.
+};
+
+extern "C" typedef HRESULT(WINAPI *PFN_BOOTSTRAPPER_APPLICATION_CREATE)(
+    __in const BOOTSTRAPPER_CREATE_ARGS* pArgs,
+    __inout BOOTSTRAPPER_CREATE_RESULTS* pResults
+    );