@joebigelow / wix-1
Code Commits Issues Pulls Sessions CI/CD
main
main
cs 2,164 lines 87.8 KB
Raw
1 // 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.
2
3 namespace WixToolset.BootstrapperApplicationApi
4 {
5 using System;
6 using System.Runtime.InteropServices;
7 using System.Threading;
8
9 /// <summary>
10 /// The default bootstrapper application.
11 /// </summary>
12 [ClassInterface(ClassInterfaceType.None)]
13 public abstract class BootstrapperApplication : MarshalByRefObject, IDefaultBootstrapperApplication
14 {
15 /// <summary>
16 /// Gets the <see cref="IEngine"/> for interaction with the engine.
17 /// </summary>
18 protected IEngine engine;
19
20 /// <inheritdoc/>
21 public event EventHandler<CreateEventArgs> Create;
22
23 /// <inheritdoc/>
24 public event EventHandler<DestroyEventArgs> Destroy;
25
26 /// <inheritdoc/>
27 public event EventHandler<StartupEventArgs> Startup;
28
29 /// <inheritdoc/>
30 public event EventHandler<ShutdownEventArgs> Shutdown;
31
32 /// <inheritdoc/>
33 public event EventHandler<DetectBeginEventArgs> DetectBegin;
34
35 /// <inheritdoc/>
36 public event EventHandler<DetectForwardCompatibleBundleEventArgs> DetectForwardCompatibleBundle;
37
38 /// <inheritdoc/>
39 public event EventHandler<DetectUpdateBeginEventArgs> DetectUpdateBegin;
40
41 /// <inheritdoc/>
42 public event EventHandler<DetectUpdateEventArgs> DetectUpdate;
43
44 /// <inheritdoc/>
45 public event EventHandler<DetectUpdateCompleteEventArgs> DetectUpdateComplete;
46
47 /// <inheritdoc/>
48 public event EventHandler<DetectRelatedBundleEventArgs> DetectRelatedBundle;
49
50 /// <inheritdoc/>
51 public event EventHandler<DetectPackageBeginEventArgs> DetectPackageBegin;
52
53 /// <inheritdoc/>
54 public event EventHandler<DetectCompatibleMsiPackageEventArgs> DetectCompatibleMsiPackage;
55
56 /// <inheritdoc/>
57 public event EventHandler<DetectRelatedMsiPackageEventArgs> DetectRelatedMsiPackage;
58
59 /// <inheritdoc/>
60 public event EventHandler<DetectPatchTargetEventArgs> DetectPatchTarget;
61
62 /// <inheritdoc/>
63 public event EventHandler<DetectMsiFeatureEventArgs> DetectMsiFeature;
64
65 /// <inheritdoc/>
66 public event EventHandler<DetectPackageCompleteEventArgs> DetectPackageComplete;
67
68 /// <inheritdoc/>
69 public event EventHandler<DetectCompleteEventArgs> DetectComplete;
70
71 /// <inheritdoc/>
72 public event EventHandler<PlanBeginEventArgs> PlanBegin;
73
74 /// <inheritdoc/>
75 public event EventHandler<PlanRelatedBundleEventArgs> PlanRelatedBundle;
76
77 /// <inheritdoc/>
78 public event EventHandler<PlanRelatedBundleTypeEventArgs> PlanRelatedBundleType;
79
80 /// <inheritdoc/>
81 public event EventHandler<PlanRollbackBoundaryEventArgs> PlanRollbackBoundary;
82
83 /// <inheritdoc/>
84 public event EventHandler<PlanPackageBeginEventArgs> PlanPackageBegin;
85
86 /// <inheritdoc/>
87 public event EventHandler<PlanCompatibleMsiPackageBeginEventArgs> PlanCompatibleMsiPackageBegin;
88
89 /// <inheritdoc/>
90 public event EventHandler<PlanCompatibleMsiPackageCompleteEventArgs> PlanCompatibleMsiPackageComplete;
91
92 /// <inheritdoc/>
93 public event EventHandler<PlanPatchTargetEventArgs> PlanPatchTarget;
94
95 /// <inheritdoc/>
96 public event EventHandler<PlanMsiFeatureEventArgs> PlanMsiFeature;
97
98 /// <inheritdoc/>
99 public event EventHandler<PlanMsiPackageEventArgs> PlanMsiPackage;
100
101 /// <inheritdoc/>
102 public event EventHandler<PlanPackageCompleteEventArgs> PlanPackageComplete;
103
104 /// <inheritdoc/>
105 public event EventHandler<PlannedCompatiblePackageEventArgs> PlannedCompatiblePackage;
106
107 /// <inheritdoc/>
108 public event EventHandler<PlannedPackageEventArgs> PlannedPackage;
109
110 /// <inheritdoc/>
111 public event EventHandler<PlanCompleteEventArgs> PlanComplete;
112
113 /// <inheritdoc/>
114 public event EventHandler<ApplyBeginEventArgs> ApplyBegin;
115
116 /// <inheritdoc/>
117 public event EventHandler<ElevateBeginEventArgs> ElevateBegin;
118
119 /// <inheritdoc/>
120 public event EventHandler<ElevateCompleteEventArgs> ElevateComplete;
121
122 /// <inheritdoc/>
123 public event EventHandler<ProgressEventArgs> Progress;
124
125 /// <inheritdoc/>
126 public event EventHandler<ErrorEventArgs> Error;
127
128 /// <inheritdoc/>
129 public event EventHandler<RegisterBeginEventArgs> RegisterBegin;
130
131 /// <inheritdoc/>
132 public event EventHandler<RegisterCompleteEventArgs> RegisterComplete;
133
134 /// <inheritdoc/>
135 public event EventHandler<UnregisterBeginEventArgs> UnregisterBegin;
136
137 /// <inheritdoc/>
138 public event EventHandler<UnregisterCompleteEventArgs> UnregisterComplete;
139
140 /// <inheritdoc/>
141 public event EventHandler<CacheBeginEventArgs> CacheBegin;
142
143 /// <inheritdoc/>
144 public event EventHandler<CachePackageBeginEventArgs> CachePackageBegin;
145
146 /// <inheritdoc/>
147 public event EventHandler<CacheAcquireBeginEventArgs> CacheAcquireBegin;
148
149 /// <inheritdoc/>
150 public event EventHandler<CacheAcquireProgressEventArgs> CacheAcquireProgress;
151
152 /// <inheritdoc/>
153 public event EventHandler<CacheAcquireResolvingEventArgs> CacheAcquireResolving;
154
155 /// <inheritdoc/>
156 public event EventHandler<CacheAcquireCompleteEventArgs> CacheAcquireComplete;
157
158 /// <inheritdoc/>
159 public event EventHandler<CacheVerifyBeginEventArgs> CacheVerifyBegin;
160
161 /// <inheritdoc/>
162 public event EventHandler<CacheVerifyProgressEventArgs> CacheVerifyProgress;
163
164 /// <inheritdoc/>
165 public event EventHandler<CacheVerifyCompleteEventArgs> CacheVerifyComplete;
166
167 /// <inheritdoc/>
168 public event EventHandler<CachePackageCompleteEventArgs> CachePackageComplete;
169
170 /// <inheritdoc/>
171 public event EventHandler<CacheCompleteEventArgs> CacheComplete;
172
173 /// <inheritdoc/>
174 public event EventHandler<ExecuteBeginEventArgs> ExecuteBegin;
175
176 /// <inheritdoc/>
177 public event EventHandler<ExecutePackageBeginEventArgs> ExecutePackageBegin;
178
179 /// <inheritdoc/>
180 public event EventHandler<ExecutePatchTargetEventArgs> ExecutePatchTarget;
181
182 /// <inheritdoc/>
183 public event EventHandler<ExecuteMsiMessageEventArgs> ExecuteMsiMessage;
184
185 /// <inheritdoc/>
186 public event EventHandler<ExecuteFilesInUseEventArgs> ExecuteFilesInUse;
187
188 /// <inheritdoc/>
189 public event EventHandler<ExecutePackageCompleteEventArgs> ExecutePackageComplete;
190
191 /// <inheritdoc/>
192 public event EventHandler<ExecuteCompleteEventArgs> ExecuteComplete;
193
194 /// <inheritdoc/>
195 public event EventHandler<ApplyCompleteEventArgs> ApplyComplete;
196
197 /// <inheritdoc/>
198 public event EventHandler<ApplyDowngradeEventArgs> ApplyDowngrade;
199
200 /// <inheritdoc/>
201 public event EventHandler<ExecuteProgressEventArgs> ExecuteProgress;
202
203 /// <inheritdoc/>
204 public event EventHandler<LaunchApprovedExeBeginEventArgs> LaunchApprovedExeBegin;
205
206 /// <inheritdoc/>
207 public event EventHandler<LaunchApprovedExeCompleteEventArgs> LaunchApprovedExeComplete;
208
209 /// <inheritdoc/>
210 public event EventHandler<BeginMsiTransactionBeginEventArgs> BeginMsiTransactionBegin;
211
212 /// <inheritdoc/>
213 public event EventHandler<BeginMsiTransactionCompleteEventArgs> BeginMsiTransactionComplete;
214
215 /// <inheritdoc/>
216 public event EventHandler<CommitMsiTransactionBeginEventArgs> CommitMsiTransactionBegin;
217
218 /// <inheritdoc/>
219 public event EventHandler<CommitMsiTransactionCompleteEventArgs> CommitMsiTransactionComplete;
220
221 /// <inheritdoc/>
222 public event EventHandler<RollbackMsiTransactionBeginEventArgs> RollbackMsiTransactionBegin;
223
224 /// <inheritdoc/>
225 public event EventHandler<RollbackMsiTransactionCompleteEventArgs> RollbackMsiTransactionComplete;
226
227 /// <inheritdoc/>
228 public event EventHandler<PauseAutomaticUpdatesBeginEventArgs> PauseAutomaticUpdatesBegin;
229
230 /// <inheritdoc/>
231 public event EventHandler<PauseAutomaticUpdatesCompleteEventArgs> PauseAutomaticUpdatesComplete;
232
233 /// <inheritdoc/>
234 public event EventHandler<SystemRestorePointBeginEventArgs> SystemRestorePointBegin;
235
236 /// <inheritdoc/>
237 public event EventHandler<SystemRestorePointCompleteEventArgs> SystemRestorePointComplete;
238
239 /// <inheritdoc/>
240 public event EventHandler<PlanForwardCompatibleBundleEventArgs> PlanForwardCompatibleBundle;
241
242 /// <inheritdoc/>
243 public event EventHandler<CacheContainerOrPayloadVerifyBeginEventArgs> CacheContainerOrPayloadVerifyBegin;
244
245 /// <inheritdoc/>
246 public event EventHandler<CacheContainerOrPayloadVerifyProgressEventArgs> CacheContainerOrPayloadVerifyProgress;
247
248 /// <inheritdoc/>
249 public event EventHandler<CacheContainerOrPayloadVerifyCompleteEventArgs> CacheContainerOrPayloadVerifyComplete;
250
251 /// <inheritdoc/>
252 public event EventHandler<CachePayloadExtractBeginEventArgs> CachePayloadExtractBegin;
253
254 /// <inheritdoc/>
255 public event EventHandler<CachePayloadExtractProgressEventArgs> CachePayloadExtractProgress;
256
257 /// <inheritdoc/>
258 public event EventHandler<CachePayloadExtractCompleteEventArgs> CachePayloadExtractComplete;
259
260 /// <inheritdoc/>
261 public event EventHandler<PlanRestoreRelatedBundleEventArgs> PlanRestoreRelatedBundle;
262
263 /// <inheritdoc/>
264 public event EventHandler<ExecuteProcessCancelEventArgs> ExecuteProcessCancel;
265
266 /// <inheritdoc/>
267 public event EventHandler<DetectRelatedBundlePackageEventArgs> DetectRelatedBundlePackage;
268
269 /// <inheritdoc/>
270 public event EventHandler<CachePackageNonVitalValidationFailureEventArgs> CachePackageNonVitalValidationFailure;
271
272 /// <summary>
273 /// The default constructor.
274 /// </summary>
275 /// <remarks>
276 /// The engine object will be valid after handling the OnCreate() event.
277 /// </remarks>
278 protected BootstrapperApplication()
279 {
280 }
281
282 /// <summary>
283 /// This constructor is no longer used.
284 /// </summary>
285 [Obsolete("This constructor is no longer used. Use the default constructor. The engine object will be valid after handling the OnCreate() event.")]
286 protected BootstrapperApplication(IEngine engine)
287 {
288 throw new NotImplementedException("This constructor is no longer used. Use the default constructor. The engine object will be valid after handling the OnCreate() event.");
289 }
290
291 /// <summary>
292 /// Entry point that is called when the bootstrapper application is ready to run.
293 /// </summary>
294 protected abstract void Run();
295
296 /// <summary>
297 /// Called by the engine, raises the <see cref="Create"/> event.
298 /// </summary>
299 /// <param name="args">Additional arguments for this event.</param>
300 protected virtual void OnCreate(CreateEventArgs args)
301 {
302 this.engine = args.Engine;
303
304 EventHandler<CreateEventArgs> handler = this.Create;
305 if (null != handler)
306 {
307 handler(this, args);
308 }
309 }
310
311 /// <summary>
312 /// Called by the engine, raises the <see cref="Destroy"/> event.
313 /// </summary>
314 /// <param name="args">Additional arguments for this event.</param>
315 protected virtual void OnDestroy(DestroyEventArgs args)
316 {
317 EventHandler<DestroyEventArgs> handler = this.Destroy;
318 if (null != handler)
319 {
320 handler(this, args);
321 }
322 }
323
324 /// <summary>
325 /// Called by the engine, raises the <see cref="Startup"/> event.
326 /// </summary>
327 /// <param name="args">Additional arguments for this event.</param>
328 protected virtual void OnStartup(StartupEventArgs args)
329 {
330 EventHandler<StartupEventArgs> handler = this.Startup;
331 if (null != handler)
332 {
333 handler(this, args);
334 }
335
336 Thread uiThread = new Thread(this.Run);
337 uiThread.Name = "UIThread";
338 uiThread.SetApartmentState(ApartmentState.STA);
339 uiThread.Start();
340 }
341
342 /// <summary>
343 /// Called by the engine, raises the <see cref="Shutdown"/> event.
344 /// </summary>
345 /// <param name="args">Additional arguments for this event.</param>
346 protected virtual void OnShutdown(ShutdownEventArgs args)
347 {
348 EventHandler<ShutdownEventArgs> handler = this.Shutdown;
349 if (null != handler)
350 {
351 handler(this, args);
352 }
353 }
354
355 /// <summary>
356 /// Called by the engine, raises the <see cref="DetectBegin"/> event.
357 /// </summary>
358 /// <param name="args">Additional arguments for this event.</param>
359 protected virtual void OnDetectBegin(DetectBeginEventArgs args)
360 {
361 EventHandler<DetectBeginEventArgs> handler = this.DetectBegin;
362 if (null != handler)
363 {
364 handler(this, args);
365 }
366 }
367
368 /// <summary>
369 /// Called by the engine, raises the <see cref="DetectForwardCompatibleBundle"/> event.
370 /// </summary>
371 /// <param name="args">Additional arguments for this event.</param>
372 protected virtual void OnDetectForwardCompatibleBundle(DetectForwardCompatibleBundleEventArgs args)
373 {
374 EventHandler<DetectForwardCompatibleBundleEventArgs> handler = this.DetectForwardCompatibleBundle;
375 if (null != handler)
376 {
377 handler(this, args);
378 }
379 }
380
381 /// <summary>
382 /// Called by the engine, raises the <see cref="DetectUpdateBegin"/> event.
383 /// </summary>
384 /// <param name="args">Additional arguments for this event.</param>
385 protected virtual void OnDetectUpdateBegin(DetectUpdateBeginEventArgs args)
386 {
387 EventHandler<DetectUpdateBeginEventArgs> handler = this.DetectUpdateBegin;
388 if (null != handler)
389 {
390 handler(this, args);
391 }
392 }
393
394 /// <summary>
395 /// Called by the engine, raises the <see cref="DetectUpdate"/> event.
396 /// </summary>
397 /// <param name="args">Additional arguments for this event.</param>
398 protected virtual void OnDetectUpdate(DetectUpdateEventArgs args)
399 {
400 EventHandler<DetectUpdateEventArgs> handler = this.DetectUpdate;
401 if (null != handler)
402 {
403 handler(this, args);
404 }
405 }
406
407 /// <summary>
408 /// Called by the engine, raises the <see cref="DetectUpdateComplete"/> event.
409 /// </summary>
410 /// <param name="args">Additional arguments for this event.</param>
411 protected virtual void OnDetectUpdateComplete(DetectUpdateCompleteEventArgs args)
412 {
413 EventHandler<DetectUpdateCompleteEventArgs> handler = this.DetectUpdateComplete;
414 if (null != handler)
415 {
416 handler(this, args);
417 }
418 }
419
420 /// <summary>
421 /// Called by the engine, raises the <see cref="DetectRelatedBundle"/> event.
422 /// </summary>
423 /// <param name="args">Additional arguments for this event.</param>
424 protected virtual void OnDetectRelatedBundle(DetectRelatedBundleEventArgs args)
425 {
426 EventHandler<DetectRelatedBundleEventArgs> handler = this.DetectRelatedBundle;
427 if (null != handler)
428 {
429 handler(this, args);
430 }
431 }
432
433 /// <summary>
434 /// Called by the engine, raises the <see cref="DetectPackageBegin"/> event.
435 /// </summary>
436 /// <param name="args">Additional arguments for this event.</param>
437 protected virtual void OnDetectPackageBegin(DetectPackageBeginEventArgs args)
438 {
439 EventHandler<DetectPackageBeginEventArgs> handler = this.DetectPackageBegin;
440 if (null != handler)
441 {
442 handler(this, args);
443 }
444 }
445
446 /// <summary>
447 /// Called by the engine, raises the <see cref="DetectCompatibleMsiPackage"/> event.
448 /// </summary>
449 /// <param name="args">Additional arguments for this event.</param>
450 protected virtual void OnDetectCompatibleMsiPackage(DetectCompatibleMsiPackageEventArgs args)
451 {
452 EventHandler<DetectCompatibleMsiPackageEventArgs> handler = this.DetectCompatibleMsiPackage;
453 if (null != handler)
454 {
455 handler(this, args);
456 }
457 }
458
459 /// <summary>
460 /// Called by the engine, raises the <see cref="DetectRelatedMsiPackage"/> event.
461 /// </summary>
462 /// <param name="args">Additional arguments for this event.</param>
463 protected virtual void OnDetectRelatedMsiPackage(DetectRelatedMsiPackageEventArgs args)
464 {
465 EventHandler<DetectRelatedMsiPackageEventArgs> handler = this.DetectRelatedMsiPackage;
466 if (null != handler)
467 {
468 handler(this, args);
469 }
470 }
471
472 /// <summary>
473 /// Called by the engine, raises the <see cref="DetectPatchTarget"/> event.
474 /// </summary>
475 /// <param name="args">Additional arguments for this event.</param>
476 protected virtual void OnDetectPatchTarget(DetectPatchTargetEventArgs args)
477 {
478 EventHandler<DetectPatchTargetEventArgs> handler = this.DetectPatchTarget;
479 if (null != handler)
480 {
481 handler(this, args);
482 }
483 }
484
485 /// <summary>
486 /// Called by the engine, raises the <see cref="DetectMsiFeature"/> event.
487 /// </summary>
488 /// <param name="args">Additional arguments for this event.</param>
489 protected virtual void OnDetectMsiFeature(DetectMsiFeatureEventArgs args)
490 {
491 EventHandler<DetectMsiFeatureEventArgs> handler = this.DetectMsiFeature;
492 if (null != handler)
493 {
494 handler(this, args);
495 }
496 }
497
498 /// <summary>
499 /// Called by the engine, raises the <see cref="DetectPackageComplete"/> event.
500 /// </summary>
501 /// <param name="args">Additional arguments for this event.</param>
502 protected virtual void OnDetectPackageComplete(DetectPackageCompleteEventArgs args)
503 {
504 EventHandler<DetectPackageCompleteEventArgs> handler = this.DetectPackageComplete;
505 if (null != handler)
506 {
507 handler(this, args);
508 }
509 }
510
511 /// <summary>
512 /// Called by the engine, raises the <see cref="DetectComplete"/> event.
513 /// </summary>
514 /// <param name="args">Additional arguments for this event.</param>
515 protected virtual void OnDetectComplete(DetectCompleteEventArgs args)
516 {
517 EventHandler<DetectCompleteEventArgs> handler = this.DetectComplete;
518 if (null != handler)
519 {
520 handler(this, args);
521 }
522 }
523
524 /// <summary>
525 /// Called by the engine, raises the <see cref="PlanBegin"/> event.
526 /// </summary>
527 /// <param name="args">Additional arguments for this event.</param>
528 protected virtual void OnPlanBegin(PlanBeginEventArgs args)
529 {
530 EventHandler<PlanBeginEventArgs> handler = this.PlanBegin;
531 if (null != handler)
532 {
533 handler(this, args);
534 }
535 }
536
537 /// <summary>
538 /// Called by the engine, raises the <see cref="PlanRelatedBundle"/> event.
539 /// </summary>
540 /// <param name="args">Additional arguments for this event.</param>
541 protected virtual void OnPlanRelatedBundle(PlanRelatedBundleEventArgs args)
542 {
543 EventHandler<PlanRelatedBundleEventArgs> handler = this.PlanRelatedBundle;
544 if (null != handler)
545 {
546 handler(this, args);
547 }
548 }
549
550 /// <summary>
551 /// Called by the engine, raises the <see cref="PlanRelatedBundleType"/> event.
552 /// </summary>
553 /// <param name="args">Additional arguments for this event.</param>
554 protected virtual void OnPlanRelatedBundleType(PlanRelatedBundleTypeEventArgs args)
555 {
556 EventHandler<PlanRelatedBundleTypeEventArgs> handler = this.PlanRelatedBundleType;
557 if (null != handler)
558 {
559 handler(this, args);
560 }
561 }
562
563 /// <summary>
564 /// Called by the engine, raises the <see cref="PlanRollbackBoundary"/> event.
565 /// </summary>
566 protected virtual void OnPlanRollbackBoundary(PlanRollbackBoundaryEventArgs args)
567 {
568 EventHandler<PlanRollbackBoundaryEventArgs> handler = this.PlanRollbackBoundary;
569 if (null != handler)
570 {
571 handler(this, args);
572 }
573 }
574
575 /// <summary>
576 /// Called by the engine, raises the <see cref="PlanPackageBegin"/> event.
577 /// </summary>
578 /// <param name="args">Additional arguments for this event.</param>
579 protected virtual void OnPlanPackageBegin(PlanPackageBeginEventArgs args)
580 {
581 EventHandler<PlanPackageBeginEventArgs> handler = this.PlanPackageBegin;
582 if (null != handler)
583 {
584 handler(this, args);
585 }
586 }
587
588 /// <summary>
589 /// Called by the engine, raises the <see cref="PlanCompatibleMsiPackageBegin"/> event.
590 /// </summary>
591 /// <param name="args">Additional arguments for this event.</param>
592 protected virtual void OnPlanCompatibleMsiPackageBegin(PlanCompatibleMsiPackageBeginEventArgs args)
593 {
594 EventHandler<PlanCompatibleMsiPackageBeginEventArgs> handler = this.PlanCompatibleMsiPackageBegin;
595 if (null != handler)
596 {
597 handler(this, args);
598 }
599 }
600
601 /// <summary>
602 /// Called by the engine, raises the <see cref="PlanCompatibleMsiPackageComplete"/> event.
603 /// </summary>
604 /// <param name="args">Additional arguments for this event.</param>
605 protected virtual void OnPlanCompatibleMsiPackageComplete(PlanCompatibleMsiPackageCompleteEventArgs args)
606 {
607 EventHandler<PlanCompatibleMsiPackageCompleteEventArgs> handler = this.PlanCompatibleMsiPackageComplete;
608 if (null != handler)
609 {
610 handler(this, args);
611 }
612 }
613
614 /// <summary>
615 /// Called by the engine, raises the <see cref="PlanPatchTarget"/> event.
616 /// </summary>
617 /// <param name="args">Additional arguments for this event.</param>
618 protected virtual void OnPlanPatchTarget(PlanPatchTargetEventArgs args)
619 {
620 EventHandler<PlanPatchTargetEventArgs> handler = this.PlanPatchTarget;
621 if (null != handler)
622 {
623 handler(this, args);
624 }
625 }
626
627 /// <summary>
628 /// Called by the engine, raises the <see cref="PlanMsiFeature"/> event.
629 /// </summary>
630 /// <param name="args">Additional arguments for this event.</param>
631 protected virtual void OnPlanMsiFeature(PlanMsiFeatureEventArgs args)
632 {
633 EventHandler<PlanMsiFeatureEventArgs> handler = this.PlanMsiFeature;
634 if (null != handler)
635 {
636 handler(this, args);
637 }
638 }
639
640 /// <summary>
641 /// Called by the engine, raises the <see cref="PlanMsiPackage"/> event.
642 /// </summary>
643 /// <param name="args">Additional arguments for this event.</param>
644 protected virtual void OnPlanMsiPackage(PlanMsiPackageEventArgs args)
645 {
646 EventHandler<PlanMsiPackageEventArgs> handler = this.PlanMsiPackage;
647 if (null != handler)
648 {
649 handler(this, args);
650 }
651 }
652
653 /// <summary>
654 /// Called by the engine, raises the <see cref="PlanPackageComplete"/> event.
655 /// </summary>
656 /// <param name="args">Additional arguments for this event.</param>
657 protected virtual void OnPlanPackageComplete(PlanPackageCompleteEventArgs args)
658 {
659 EventHandler<PlanPackageCompleteEventArgs> handler = this.PlanPackageComplete;
660 if (null != handler)
661 {
662 handler(this, args);
663 }
664 }
665
666 /// <summary>
667 /// Called by the engine, raises the <see cref="PlannedCompatiblePackage"/> event.
668 /// </summary>
669 /// <param name="args">Additional arguments for this event.</param>
670 protected virtual void OnPlannedCompatiblePackage(PlannedCompatiblePackageEventArgs args)
671 {
672 EventHandler<PlannedCompatiblePackageEventArgs> handler = this.PlannedCompatiblePackage;
673 if (null != handler)
674 {
675 handler(this, args);
676 }
677 }
678
679 /// <summary>
680 /// Called by the engine, raises the <see cref="PlannedPackage"/> event.
681 /// </summary>
682 /// <param name="args">Additional arguments for this event.</param>
683 protected virtual void OnPlannedPackage(PlannedPackageEventArgs args)
684 {
685 EventHandler<PlannedPackageEventArgs> handler = this.PlannedPackage;
686 if (null != handler)
687 {
688 handler(this, args);
689 }
690 }
691
692 /// <summary>
693 /// Called by the engine, raises the <see cref="PlanComplete"/> event.
694 /// </summary>
695 /// <param name="args">Additional arguments for this event.</param>
696 protected virtual void OnPlanComplete(PlanCompleteEventArgs args)
697 {
698 EventHandler<PlanCompleteEventArgs> handler = this.PlanComplete;
699 if (null != handler)
700 {
701 handler(this, args);
702 }
703 }
704
705 /// <summary>
706 /// Called by the engine, raises the <see cref="ApplyBegin"/> event.
707 /// </summary>
708 /// <param name="args">Additional arguments for this event.</param>
709 protected virtual void OnApplyBegin(ApplyBeginEventArgs args)
710 {
711 EventHandler<ApplyBeginEventArgs> handler = this.ApplyBegin;
712 if (null != handler)
713 {
714 handler(this, args);
715 }
716 }
717
718 /// <summary>
719 /// Called by the engine, raises the <see cref="ElevateBegin"/> event.
720 /// </summary>
721 /// <param name="args">Additional arguments for this event.</param>
722 protected virtual void OnElevateBegin(ElevateBeginEventArgs args)
723 {
724 EventHandler<ElevateBeginEventArgs> handler = this.ElevateBegin;
725 if (null != handler)
726 {
727 handler(this, args);
728 }
729 }
730
731 /// <summary>
732 /// Called by the engine, raises the <see cref="ElevateComplete"/> event.
733 /// </summary>
734 /// <param name="args">Additional arguments for this event.</param>
735 protected virtual void OnElevateComplete(ElevateCompleteEventArgs args)
736 {
737 EventHandler<ElevateCompleteEventArgs> handler = this.ElevateComplete;
738 if (null != handler)
739 {
740 handler(this, args);
741 }
742 }
743
744 /// <summary>
745 /// Called by the engine, raises the <see cref="Progress"/> event.
746 /// </summary>
747 /// <param name="args">Additional arguments for this event.</param>
748 protected virtual void OnProgress(ProgressEventArgs args)
749 {
750 EventHandler<ProgressEventArgs> handler = this.Progress;
751 if (null != handler)
752 {
753 handler(this, args);
754 }
755 }
756
757 /// <summary>
758 /// Called by the engine, raises the <see cref="Error"/> event.
759 /// </summary>
760 /// <param name="args">Additional arguments for this event.</param>
761 protected virtual void OnError(ErrorEventArgs args)
762 {
763 EventHandler<ErrorEventArgs> handler = this.Error;
764 if (null != handler)
765 {
766 handler(this, args);
767 }
768 }
769
770 /// <summary>
771 /// Called by the engine, raises the <see cref="RegisterBegin"/> event.
772 /// </summary>
773 /// <param name="args">Additional arguments for this event.</param>
774 protected virtual void OnRegisterBegin(RegisterBeginEventArgs args)
775 {
776 EventHandler<RegisterBeginEventArgs> handler = this.RegisterBegin;
777 if (null != handler)
778 {
779 handler(this, args);
780 }
781 }
782
783 /// <summary>
784 /// Called by the engine, raises the <see cref="RegisterComplete"/> event.
785 /// </summary>
786 /// <param name="args">Additional arguments for this event.</param>
787 protected virtual void OnRegisterComplete(RegisterCompleteEventArgs args)
788 {
789 EventHandler<RegisterCompleteEventArgs> handler = this.RegisterComplete;
790 if (null != handler)
791 {
792 handler(this, args);
793 }
794 }
795
796 /// <summary>
797 /// Called by the engine, raises the <see cref="UnregisterBegin"/> event.
798 /// </summary>
799 /// <param name="args">Additional arguments for this event.</param>
800 protected virtual void OnUnregisterBegin(UnregisterBeginEventArgs args)
801 {
802 EventHandler<UnregisterBeginEventArgs> handler = this.UnregisterBegin;
803 if (null != handler)
804 {
805 handler(this, args);
806 }
807 }
808
809 /// <summary>
810 /// Called by the engine, raises the <see cref="UnregisterComplete"/> event.
811 /// </summary>
812 /// <param name="args">Additional arguments for this event.</param>
813 protected virtual void OnUnregisterComplete(UnregisterCompleteEventArgs args)
814 {
815 EventHandler<UnregisterCompleteEventArgs> handler = this.UnregisterComplete;
816 if (null != handler)
817 {
818 handler(this, args);
819 }
820 }
821
822 /// <summary>
823 /// Called by the engine, raises the <see cref="CacheBegin"/> event.
824 /// </summary>
825 /// <param name="args">Additional arguments for this event.</param>
826 protected virtual void OnCacheBegin(CacheBeginEventArgs args)
827 {
828 EventHandler<CacheBeginEventArgs> handler = this.CacheBegin;
829 if (null != handler)
830 {
831 handler(this, args);
832 }
833 }
834
835 /// <summary>
836 /// Called by the engine, raises the <see cref="CachePackageBegin"/> event.
837 /// </summary>
838 /// <param name="args">Additional arguments for this event.</param>
839 protected virtual void OnCachePackageBegin(CachePackageBeginEventArgs args)
840 {
841 EventHandler<CachePackageBeginEventArgs> handler = this.CachePackageBegin;
842 if (null != handler)
843 {
844 handler(this, args);
845 }
846 }
847
848 /// <summary>
849 /// Called by the engine, raises the <see cref="CacheAcquireBegin"/> event.
850 /// </summary>
851 /// <param name="args">Additional arguments for this event.</param>
852 protected virtual void OnCacheAcquireBegin(CacheAcquireBeginEventArgs args)
853 {
854 EventHandler<CacheAcquireBeginEventArgs> handler = this.CacheAcquireBegin;
855 if (null != handler)
856 {
857 handler(this, args);
858 }
859 }
860
861 /// <summary>
862 /// Called by the engine, raises the <see cref="CacheAcquireProgress"/> event.
863 /// </summary>
864 /// <param name="args">Additional arguments for this event.</param>
865 protected virtual void OnCacheAcquireProgress(CacheAcquireProgressEventArgs args)
866 {
867 EventHandler<CacheAcquireProgressEventArgs> handler = this.CacheAcquireProgress;
868 if (null != handler)
869 {
870 handler(this, args);
871 }
872 }
873
874 /// <summary>
875 /// Called by the engine, raises the <see cref="CacheAcquireResolving"/> event.
876 /// </summary>
877 /// <param name="args">Additional arguments for this event.</param>
878 protected virtual void OnCacheAcquireResolving(CacheAcquireResolvingEventArgs args)
879 {
880 EventHandler<CacheAcquireResolvingEventArgs> handler = this.CacheAcquireResolving;
881 if (null != handler)
882 {
883 handler(this, args);
884 }
885 }
886
887 /// <summary>
888 /// Called by the engine, raises the <see cref="CacheAcquireComplete"/> event.
889 /// </summary>
890 /// <param name="args">Additional arguments for this event.</param>
891 protected virtual void OnCacheAcquireComplete(CacheAcquireCompleteEventArgs args)
892 {
893 EventHandler<CacheAcquireCompleteEventArgs> handler = this.CacheAcquireComplete;
894 if (null != handler)
895 {
896 handler(this, args);
897 }
898 }
899
900 /// <summary>
901 /// Called by the engine, raises the <see cref="CacheVerifyBegin"/> event.
902 /// </summary>
903 /// <param name="args">Additional arguments for this event.</param>
904 protected virtual void OnCacheVerifyBegin(CacheVerifyBeginEventArgs args)
905 {
906 EventHandler<CacheVerifyBeginEventArgs> handler = this.CacheVerifyBegin;
907 if (null != handler)
908 {
909 handler(this, args);
910 }
911 }
912
913 /// <summary>
914 /// Called by the engine, raises the <see cref="CacheVerifyProgress"/> event.
915 /// </summary>
916 /// <param name="args">Additional arguments for this event.</param>
917 protected virtual void OnCacheVerifyProgress(CacheVerifyProgressEventArgs args)
918 {
919 EventHandler<CacheVerifyProgressEventArgs> handler = this.CacheVerifyProgress;
920 if (null != handler)
921 {
922 handler(this, args);
923 }
924 }
925
926 /// <summary>
927 /// Called by the engine, raises the <see cref="CacheVerifyComplete"/> event.
928 /// </summary>
929 /// <param name="args">Additional arguments for this event.</param>
930 protected virtual void OnCacheVerifyComplete(CacheVerifyCompleteEventArgs args)
931 {
932 EventHandler<CacheVerifyCompleteEventArgs> handler = this.CacheVerifyComplete;
933 if (null != handler)
934 {
935 handler(this, args);
936 }
937 }
938
939 /// <summary>
940 /// Called by the engine, raises the <see cref="CachePackageComplete"/> event.
941 /// </summary>
942 /// <param name="args">Additional arguments for this event.</param>
943 protected virtual void OnCachePackageComplete(CachePackageCompleteEventArgs args)
944 {
945 EventHandler<CachePackageCompleteEventArgs> handler = this.CachePackageComplete;
946 if (null != handler)
947 {
948 handler(this, args);
949 }
950 }
951
952 /// <summary>
953 /// Called by the engine, raises the <see cref="CacheComplete"/> event.
954 /// </summary>
955 /// <param name="args">Additional arguments for this event.</param>
956 protected virtual void OnCacheComplete(CacheCompleteEventArgs args)
957 {
958 EventHandler<CacheCompleteEventArgs> handler = this.CacheComplete;
959 if (null != handler)
960 {
961 handler(this, args);
962 }
963 }
964
965 /// <summary>
966 /// Called by the engine, raises the <see cref="ExecuteBegin"/> event.
967 /// </summary>
968 /// <param name="args">Additional arguments for this event.</param>
969 protected virtual void OnExecuteBegin(ExecuteBeginEventArgs args)
970 {
971 EventHandler<ExecuteBeginEventArgs> handler = this.ExecuteBegin;
972 if (null != handler)
973 {
974 handler(this, args);
975 }
976 }
977
978 /// <summary>
979 /// Called by the engine, raises the <see cref="ExecutePackageBegin"/> event.
980 /// </summary>
981 /// <param name="args">Additional arguments for this event.</param>
982 protected virtual void OnExecutePackageBegin(ExecutePackageBeginEventArgs args)
983 {
984 EventHandler<ExecutePackageBeginEventArgs> handler = this.ExecutePackageBegin;
985 if (null != handler)
986 {
987 handler(this, args);
988 }
989 }
990
991 /// <summary>
992 /// Called by the engine, raises the <see cref="ExecutePatchTarget"/> event.
993 /// </summary>
994 /// <param name="args">Additional arguments for this event.</param>
995 protected virtual void OnExecutePatchTarget(ExecutePatchTargetEventArgs args)
996 {
997 EventHandler<ExecutePatchTargetEventArgs> handler = this.ExecutePatchTarget;
998 if (null != handler)
999 {
1000 handler(this, args);
1001 }
1002 }
1003
1004 /// <summary>
1005 /// Called by the engine, raises the <see cref="ExecuteMsiMessage"/> event.
1006 /// </summary>
1007 /// <param name="args">Additional arguments for this event.</param>
1008 protected virtual void OnExecuteMsiMessage(ExecuteMsiMessageEventArgs args)
1009 {
1010 EventHandler<ExecuteMsiMessageEventArgs> handler = this.ExecuteMsiMessage;
1011 if (null != handler)
1012 {
1013 handler(this, args);
1014 }
1015 }
1016
1017 /// <summary>
1018 /// Called by the engine, raises the <see cref="ExecuteFilesInUse"/> event.
1019 /// </summary>
1020 /// <param name="args">Additional arguments for this event.</param>
1021 protected virtual void OnExecuteFilesInUse(ExecuteFilesInUseEventArgs args)
1022 {
1023 EventHandler<ExecuteFilesInUseEventArgs> handler = this.ExecuteFilesInUse;
1024 if (null != handler)
1025 {
1026 handler(this, args);
1027 }
1028 }
1029
1030 /// <summary>
1031 /// Called by the engine, raises the <see cref="ExecutePackageComplete"/> event.
1032 /// </summary>
1033 /// <param name="args">Additional arguments for this event.</param>
1034 protected virtual void OnExecutePackageComplete(ExecutePackageCompleteEventArgs args)
1035 {
1036 EventHandler<ExecutePackageCompleteEventArgs> handler = this.ExecutePackageComplete;
1037 if (null != handler)
1038 {
1039 handler(this, args);
1040 }
1041 }
1042
1043 /// <summary>
1044 /// Called by the engine, raises the <see cref="ExecuteComplete"/> event.
1045 /// </summary>
1046 /// <param name="args">Additional arguments for this event.</param>
1047 protected virtual void OnExecuteComplete(ExecuteCompleteEventArgs args)
1048 {
1049 EventHandler<ExecuteCompleteEventArgs> handler = this.ExecuteComplete;
1050 if (null != handler)
1051 {
1052 handler(this, args);
1053 }
1054 }
1055
1056 /// <summary>
1057 /// Called by the engine, raises the <see cref="ApplyComplete"/> event.
1058 /// </summary>
1059 /// <param name="args">Additional arguments for this event.</param>
1060 protected virtual void OnApplyComplete(ApplyCompleteEventArgs args)
1061 {
1062 EventHandler<ApplyCompleteEventArgs> handler = this.ApplyComplete;
1063 if (null != handler)
1064 {
1065 handler(this, args);
1066 }
1067 }
1068
1069 /// <summary>
1070 /// Called by the engine, raises the <see cref="ApplyDowngrade"/> event.
1071 /// </summary>
1072 /// <param name="args">Additional arguments for this event.</param>
1073 protected virtual void OnApplyDowngrade(ApplyDowngradeEventArgs args)
1074 {
1075 EventHandler<ApplyDowngradeEventArgs> handler = this.ApplyDowngrade;
1076 if (null != handler)
1077 {
1078 handler(this, args);
1079 }
1080 }
1081
1082 /// <summary>
1083 /// Called by the engine, raises the <see cref="ExecuteProgress"/> event.
1084 /// </summary>
1085 /// <param name="args">Additional arguments for this event.</param>
1086 protected virtual void OnExecuteProgress(ExecuteProgressEventArgs args)
1087 {
1088 EventHandler<ExecuteProgressEventArgs> handler = this.ExecuteProgress;
1089 if (null != handler)
1090 {
1091 handler(this, args);
1092 }
1093 }
1094
1095 /// <summary>
1096 /// Called by the engine, raises the <see cref="LaunchApprovedExeBegin"/> event.
1097 /// </summary>
1098 /// <param name="args">Additional arguments for this event.</param>
1099 protected virtual void OnLaunchApprovedExeBegin(LaunchApprovedExeBeginEventArgs args)
1100 {
1101 EventHandler<LaunchApprovedExeBeginEventArgs> handler = this.LaunchApprovedExeBegin;
1102 if (null != handler)
1103 {
1104 handler(this, args);
1105 }
1106 }
1107
1108 /// <summary>
1109 /// Called by the engine, raises the <see cref="LaunchApprovedExeComplete"/> event.
1110 /// </summary>
1111 /// <param name="args">Additional arguments for this event.</param>
1112 protected virtual void OnLaunchApprovedExeComplete(LaunchApprovedExeCompleteEventArgs args)
1113 {
1114 EventHandler<LaunchApprovedExeCompleteEventArgs> handler = this.LaunchApprovedExeComplete;
1115 if (null != handler)
1116 {
1117 handler(this, args);
1118 }
1119 }
1120
1121 /// <summary>
1122 /// Called by the engine, raises the <see cref="BeginMsiTransactionBegin"/> event.
1123 /// </summary>
1124 /// <param name="args">Additional arguments for this event.</param>
1125 protected virtual void OnBeginMsiTransactionBegin(BeginMsiTransactionBeginEventArgs args)
1126 {
1127 EventHandler<BeginMsiTransactionBeginEventArgs> handler = this.BeginMsiTransactionBegin;
1128 if (null != handler)
1129 {
1130 handler(this, args);
1131 }
1132 }
1133
1134 /// <summary>
1135 /// Called by the engine, raises the <see cref="BeginMsiTransactionComplete"/> event.
1136 /// </summary>
1137 /// <param name="args">Additional arguments for this event.</param>
1138 protected virtual void OnBeginMsiTransactionComplete(BeginMsiTransactionCompleteEventArgs args)
1139 {
1140 EventHandler<BeginMsiTransactionCompleteEventArgs> handler = this.BeginMsiTransactionComplete;
1141 if (null != handler)
1142 {
1143 handler(this, args);
1144 }
1145 }
1146
1147 /// <summary>
1148 /// Called by the engine, raises the <see cref="CommitMsiTransactionBegin"/> event.
1149 /// </summary>
1150 /// <param name="args">Additional arguments for this event.</param>
1151 protected virtual void OnCommitMsiTransactionBegin(CommitMsiTransactionBeginEventArgs args)
1152 {
1153 EventHandler<CommitMsiTransactionBeginEventArgs> handler = this.CommitMsiTransactionBegin;
1154 if (null != handler)
1155 {
1156 handler(this, args);
1157 }
1158 }
1159
1160 /// <summary>
1161 /// Called by the engine, raises the <see cref="CommitMsiTransactionComplete"/> event.
1162 /// </summary>
1163 /// <param name="args">Additional arguments for this event.</param>
1164 protected virtual void OnCommitMsiTransactionComplete(CommitMsiTransactionCompleteEventArgs args)
1165 {
1166 EventHandler<CommitMsiTransactionCompleteEventArgs> handler = this.CommitMsiTransactionComplete;
1167 if (null != handler)
1168 {
1169 handler(this, args);
1170 }
1171 }
1172
1173 /// <summary>
1174 /// Called by the engine, raises the <see cref="RollbackMsiTransactionBegin"/> event.
1175 /// </summary>
1176 /// <param name="args">Additional arguments for this event.</param>
1177 protected virtual void OnRollbackMsiTransactionBegin(RollbackMsiTransactionBeginEventArgs args)
1178 {
1179 EventHandler<RollbackMsiTransactionBeginEventArgs> handler = this.RollbackMsiTransactionBegin;
1180 if (null != handler)
1181 {
1182 handler(this, args);
1183 }
1184 }
1185
1186 /// <summary>
1187 /// Called by the engine, raises the <see cref="RollbackMsiTransactionComplete"/> event.
1188 /// </summary>
1189 /// <param name="args">Additional arguments for this event.</param>
1190 protected virtual void OnRollbackMsiTransactionComplete(RollbackMsiTransactionCompleteEventArgs args)
1191 {
1192 EventHandler<RollbackMsiTransactionCompleteEventArgs> handler = this.RollbackMsiTransactionComplete;
1193 if (null != handler)
1194 {
1195 handler(this, args);
1196 }
1197 }
1198
1199 /// <summary>
1200 /// Called by the engine, raises the <see cref="PauseAutomaticUpdatesBegin"/> event.
1201 /// </summary>
1202 /// <param name="args">Additional arguments for this event.</param>
1203 protected virtual void OnPauseAutomaticUpdatesBegin(PauseAutomaticUpdatesBeginEventArgs args)
1204 {
1205 EventHandler<PauseAutomaticUpdatesBeginEventArgs> handler = this.PauseAutomaticUpdatesBegin;
1206 if (null != handler)
1207 {
1208 handler(this, args);
1209 }
1210 }
1211
1212 /// <summary>
1213 /// Called by the engine, raises the <see cref="PauseAutomaticUpdatesComplete"/> event.
1214 /// </summary>
1215 /// <param name="args">Additional arguments for this event.</param>
1216 protected virtual void OnPauseAutomaticUpdatesComplete(PauseAutomaticUpdatesCompleteEventArgs args)
1217 {
1218 EventHandler<PauseAutomaticUpdatesCompleteEventArgs> handler = this.PauseAutomaticUpdatesComplete;
1219 if (null != handler)
1220 {
1221 handler(this, args);
1222 }
1223 }
1224
1225 /// <summary>
1226 /// Called by the engine, raises the <see cref="SystemRestorePointBegin"/> event.
1227 /// </summary>
1228 /// <param name="args">Additional arguments for this event.</param>
1229 protected virtual void OnSystemRestorePointBegin(SystemRestorePointBeginEventArgs args)
1230 {
1231 EventHandler<SystemRestorePointBeginEventArgs> handler = this.SystemRestorePointBegin;
1232 if (null != handler)
1233 {
1234 handler(this, args);
1235 }
1236 }
1237
1238 /// <summary>
1239 /// Called by the engine, raises the <see cref="SystemRestorePointComplete"/> event.
1240 /// </summary>
1241 /// <param name="args">Additional arguments for this event.</param>
1242 protected virtual void OnSystemRestorePointComplete(SystemRestorePointCompleteEventArgs args)
1243 {
1244 EventHandler<SystemRestorePointCompleteEventArgs> handler = this.SystemRestorePointComplete;
1245 if (null != handler)
1246 {
1247 handler(this, args);
1248 }
1249 }
1250
1251 /// <summary>
1252 /// Called by the engine, raises the <see cref="PlanForwardCompatibleBundle"/> event.
1253 /// </summary>
1254 /// <param name="args">Additional arguments for this event.</param>
1255 protected virtual void OnPlanForwardCompatibleBundle(PlanForwardCompatibleBundleEventArgs args)
1256 {
1257 EventHandler<PlanForwardCompatibleBundleEventArgs> handler = this.PlanForwardCompatibleBundle;
1258 if (null != handler)
1259 {
1260 handler(this, args);
1261 }
1262 }
1263
1264 /// <summary>
1265 /// Called by the engine, raises the <see cref="CacheContainerOrPayloadVerifyBegin"/> event.
1266 /// </summary>
1267 /// <param name="args">Additional arguments for this event.</param>
1268 protected virtual void OnCacheContainerOrPayloadVerifyBegin(CacheContainerOrPayloadVerifyBeginEventArgs args)
1269 {
1270 EventHandler<CacheContainerOrPayloadVerifyBeginEventArgs> handler = this.CacheContainerOrPayloadVerifyBegin;
1271 if (null != handler)
1272 {
1273 handler(this, args);
1274 }
1275 }
1276
1277 /// <summary>
1278 /// Called by the engine, raises the <see cref="CacheContainerOrPayloadVerifyProgress"/> event.
1279 /// </summary>
1280 /// <param name="args">Additional arguments for this event.</param>
1281 protected virtual void OnCacheContainerOrPayloadVerifyProgress(CacheContainerOrPayloadVerifyProgressEventArgs args)
1282 {
1283 EventHandler<CacheContainerOrPayloadVerifyProgressEventArgs> handler = this.CacheContainerOrPayloadVerifyProgress;
1284 if (null != handler)
1285 {
1286 handler(this, args);
1287 }
1288 }
1289
1290 /// <summary>
1291 /// Called by the engine, raises the <see cref="CacheContainerOrPayloadVerifyComplete"/> event.
1292 /// </summary>
1293 /// <param name="args">Additional arguments for this event.</param>
1294 protected virtual void OnCacheContainerOrPayloadVerifyComplete(CacheContainerOrPayloadVerifyCompleteEventArgs args)
1295 {
1296 EventHandler<CacheContainerOrPayloadVerifyCompleteEventArgs> handler = this.CacheContainerOrPayloadVerifyComplete;
1297 if (null != handler)
1298 {
1299 handler(this, args);
1300 }
1301 }
1302
1303 /// <summary>
1304 /// Called by the engine, raises the <see cref="CachePayloadExtractBegin"/> event.
1305 /// </summary>
1306 /// <param name="args">Additional arguments for this event.</param>
1307 protected virtual void OnCachePayloadExtractBegin(CachePayloadExtractBeginEventArgs args)
1308 {
1309 EventHandler<CachePayloadExtractBeginEventArgs> handler = this.CachePayloadExtractBegin;
1310 if (null != handler)
1311 {
1312 handler(this, args);
1313 }
1314 }
1315
1316 /// <summary>
1317 /// Called by the engine, raises the <see cref="CachePayloadExtractProgress"/> event.
1318 /// </summary>
1319 /// <param name="args">Additional arguments for this event.</param>
1320 protected virtual void OnCachePayloadExtractProgress(CachePayloadExtractProgressEventArgs args)
1321 {
1322 EventHandler<CachePayloadExtractProgressEventArgs> handler = this.CachePayloadExtractProgress;
1323 if (null != handler)
1324 {
1325 handler(this, args);
1326 }
1327 }
1328
1329 /// <summary>
1330 /// Called by the engine, raises the <see cref="CachePayloadExtractComplete"/> event.
1331 /// </summary>
1332 /// <param name="args">Additional arguments for this event.</param>
1333 protected virtual void OnCachePayloadExtractComplete(CachePayloadExtractCompleteEventArgs args)
1334 {
1335 EventHandler<CachePayloadExtractCompleteEventArgs> handler = this.CachePayloadExtractComplete;
1336 if (null != handler)
1337 {
1338 handler(this, args);
1339 }
1340 }
1341
1342
1343 /// <summary>
1344 /// Called by the engine, raises the <see cref="PlanRestoreRelatedBundle"/> event.
1345 /// </summary>
1346 /// <param name="args">Additional arguments for this event.</param>
1347 protected virtual void OnPlanRestoreRelatedBundle(PlanRestoreRelatedBundleEventArgs args)
1348 {
1349 EventHandler<PlanRestoreRelatedBundleEventArgs> handler = this.PlanRestoreRelatedBundle;
1350 if (null != handler)
1351 {
1352 handler(this, args);
1353 }
1354 }
1355
1356 /// <summary>
1357 /// Called by the engine, raises the <see cref="ExecuteProcessCancel"/> event.
1358 /// </summary>
1359 /// <param name="args">Additional arguments for this event.</param>
1360 protected virtual void OnExecuteProcessCancel(ExecuteProcessCancelEventArgs args)
1361 {
1362 EventHandler<ExecuteProcessCancelEventArgs> handler = this.ExecuteProcessCancel;
1363 if (null != handler)
1364 {
1365 handler(this, args);
1366 }
1367 }
1368
1369 /// <summary>
1370 /// Called by the engine, raises the <see cref="DetectRelatedBundlePackage"/> event.
1371 /// </summary>
1372 /// <param name="args">Additional arguments for this event.</param>
1373 protected virtual void OnDetectRelatedBundlePackage(DetectRelatedBundlePackageEventArgs args)
1374 {
1375 EventHandler<DetectRelatedBundlePackageEventArgs> handler = this.DetectRelatedBundlePackage;
1376 if (null != handler)
1377 {
1378 handler(this, args);
1379 }
1380 }
1381
1382 /// <summary>
1383 /// Called by the engine, raises the <see cref="CachePackageNonVitalValidationFailure"/> event.
1384 /// </summary>
1385 /// <param name="args">Additional arguments for this event.</param>
1386 protected virtual void OnCachePackageNonVitalValidationFailure(CachePackageNonVitalValidationFailureEventArgs args)
1387 {
1388 EventHandler<CachePackageNonVitalValidationFailureEventArgs> handler = this.CachePackageNonVitalValidationFailure;
1389 if (null != handler)
1390 {
1391 handler(this, args);
1392 }
1393 }
1394
1395 #region IBootstrapperApplication Members
1396
1397 int IBootstrapperApplication.BAProc(int message, IntPtr pvArgs, IntPtr pvResults)
1398 {
1399 switch (message)
1400 {
1401 default:
1402 return NativeMethods.E_NOTIMPL;
1403 }
1404 }
1405
1406 void IBootstrapperApplication.BAProcFallback(int message, IntPtr pvArgs, IntPtr pvResults, ref int phr)
1407 {
1408 }
1409
1410 int IBootstrapperApplication.OnCreate(IBootstrapperEngine engine, ref Command command)
1411 {
1412 CreateEventArgs args = new CreateEventArgs(new Engine(engine), command.GetBootstrapperCommand());
1413 this.OnCreate(args);
1414
1415 return args.HResult;
1416 }
1417
1418 int IBootstrapperApplication.OnDestroy(bool reload)
1419 {
1420 DestroyEventArgs args = new DestroyEventArgs(reload);
1421 this.OnDestroy(args);
1422
1423 return args.HResult;
1424 }
1425
1426 int IBootstrapperApplication.OnStartup()
1427 {
1428 StartupEventArgs args = new StartupEventArgs();
1429 this.OnStartup(args);
1430
1431 return args.HResult;
1432 }
1433
1434 int IBootstrapperApplication.OnShutdown(ref BOOTSTRAPPER_SHUTDOWN_ACTION action)
1435 {
1436 ShutdownEventArgs args = new ShutdownEventArgs(action);
1437 this.OnShutdown(args);
1438
1439 action = args.Action;
1440 return args.HResult;
1441 }
1442
1443 int IBootstrapperApplication.OnDetectBegin(bool fCached, RegistrationType registrationType, int cPackages, ref bool fCancel)
1444 {
1445 DetectBeginEventArgs args = new DetectBeginEventArgs(fCached, registrationType, cPackages, fCancel);
1446 this.OnDetectBegin(args);
1447
1448 fCancel = args.Cancel;
1449 return args.HResult;
1450 }
1451
1452 int IBootstrapperApplication.OnDetectForwardCompatibleBundle(string wzBundleId, RelationType relationType, string wzBundleTag, bool fPerMachine, string wzVersion, bool fMissingFromCache, ref bool fCancel)
1453 {
1454 DetectForwardCompatibleBundleEventArgs args = new DetectForwardCompatibleBundleEventArgs(wzBundleId, relationType, wzBundleTag, fPerMachine, wzVersion, fMissingFromCache, fCancel);
1455 this.OnDetectForwardCompatibleBundle(args);
1456
1457 fCancel = args.Cancel;
1458 return args.HResult;
1459 }
1460
1461 int IBootstrapperApplication.OnDetectUpdateBegin(string wzUpdateLocation, ref bool fCancel, ref bool fSkip)
1462 {
1463 DetectUpdateBeginEventArgs args = new DetectUpdateBeginEventArgs(wzUpdateLocation, fCancel, fSkip);
1464 this.OnDetectUpdateBegin(args);
1465
1466 fCancel = args.Cancel;
1467 fSkip = args.Skip;
1468 return args.HResult;
1469 }
1470
1471 int IBootstrapperApplication.OnDetectUpdate(string wzUpdateLocation, long dw64Size, string wzHash, UpdateHashType hashAlgorithm, string wzVersion, string wzTitle, string wzSummary, string wzContentType, string wzContent, ref bool fCancel, ref bool fStopProcessingUpdates)
1472 {
1473 DetectUpdateEventArgs args = new DetectUpdateEventArgs(wzUpdateLocation, dw64Size, wzHash, hashAlgorithm, wzVersion, wzTitle, wzSummary, wzContentType, wzContent, fCancel, fStopProcessingUpdates);
1474 this.OnDetectUpdate(args);
1475
1476 fCancel = args.Cancel;
1477 fStopProcessingUpdates = args.StopProcessingUpdates;
1478 return args.HResult;
1479 }
1480
1481 int IBootstrapperApplication.OnDetectUpdateComplete(int hrStatus, ref bool fIgnoreError)
1482 {
1483 DetectUpdateCompleteEventArgs args = new DetectUpdateCompleteEventArgs(hrStatus, fIgnoreError);
1484 this.OnDetectUpdateComplete(args);
1485
1486 fIgnoreError = args.IgnoreError;
1487 return args.HResult;
1488 }
1489
1490 int IBootstrapperApplication.OnDetectRelatedBundle(string wzProductCode, RelationType relationType, string wzBundleTag, bool fPerMachine, string wzVersion, bool fMissingFromCache, ref bool fCancel)
1491 {
1492 DetectRelatedBundleEventArgs args = new DetectRelatedBundleEventArgs(wzProductCode, relationType, wzBundleTag, fPerMachine, wzVersion, fMissingFromCache, fCancel);
1493 this.OnDetectRelatedBundle(args);
1494
1495 fCancel = args.Cancel;
1496 return args.HResult;
1497 }
1498
1499 int IBootstrapperApplication.OnDetectPackageBegin(string wzPackageId, ref bool fCancel)
1500 {
1501 DetectPackageBeginEventArgs args = new DetectPackageBeginEventArgs(wzPackageId, fCancel);
1502 this.OnDetectPackageBegin(args);
1503
1504 fCancel = args.Cancel;
1505 return args.HResult;
1506 }
1507
1508 int IBootstrapperApplication.OnDetectCompatibleMsiPackage(string wzPackageId, string wzCompatiblePackageId, string wzCompatiblePackageVersion, ref bool fCancel)
1509 {
1510 DetectCompatibleMsiPackageEventArgs args = new DetectCompatibleMsiPackageEventArgs(wzPackageId, wzCompatiblePackageId, wzCompatiblePackageVersion, fCancel);
1511 this.OnDetectCompatibleMsiPackage(args);
1512
1513 fCancel = args.Cancel;
1514 return args.HResult;
1515 }
1516
1517 int IBootstrapperApplication.OnDetectRelatedMsiPackage(string wzPackageId, string wzUpgradeCode, string wzProductCode, bool fPerMachine, string wzVersion, RelatedOperation operation, ref bool fCancel)
1518 {
1519 DetectRelatedMsiPackageEventArgs args = new DetectRelatedMsiPackageEventArgs(wzPackageId, wzUpgradeCode, wzProductCode, fPerMachine, wzVersion, operation, fCancel);
1520 this.OnDetectRelatedMsiPackage(args);
1521
1522 fCancel = args.Cancel;
1523 return args.HResult;
1524 }
1525
1526 int IBootstrapperApplication.OnDetectPatchTarget(string wzPackageId, string wzProductCode, PackageState patchState, ref bool fCancel)
1527 {
1528 DetectPatchTargetEventArgs args = new DetectPatchTargetEventArgs(wzPackageId, wzProductCode, patchState, fCancel);
1529 this.OnDetectPatchTarget(args);
1530
1531 fCancel = args.Cancel;
1532 return args.HResult;
1533 }
1534
1535 int IBootstrapperApplication.OnDetectMsiFeature(string wzPackageId, string wzFeatureId, FeatureState state, ref bool fCancel)
1536 {
1537 DetectMsiFeatureEventArgs args = new DetectMsiFeatureEventArgs(wzPackageId, wzFeatureId, state, fCancel);
1538 this.OnDetectMsiFeature(args);
1539
1540 fCancel = args.Cancel;
1541 return args.HResult;
1542 }
1543
1544 int IBootstrapperApplication.OnDetectPackageComplete(string wzPackageId, int hrStatus, PackageState state, bool fCached)
1545 {
1546 DetectPackageCompleteEventArgs args = new DetectPackageCompleteEventArgs(wzPackageId, hrStatus, state, fCached);
1547 this.OnDetectPackageComplete(args);
1548
1549 return args.HResult;
1550 }
1551
1552 int IBootstrapperApplication.OnDetectComplete(int hrStatus, bool fEligibleForCleanup)
1553 {
1554 DetectCompleteEventArgs args = new DetectCompleteEventArgs(hrStatus, fEligibleForCleanup);
1555 this.OnDetectComplete(args);
1556
1557 return args.HResult;
1558 }
1559
1560 int IBootstrapperApplication.OnPlanBegin(int cPackages, ref bool fCancel)
1561 {
1562 PlanBeginEventArgs args = new PlanBeginEventArgs(cPackages, fCancel);
1563 this.OnPlanBegin(args);
1564
1565 fCancel = args.Cancel;
1566 return args.HResult;
1567 }
1568
1569 int IBootstrapperApplication.OnPlanRelatedBundle(string wzBundleId, RequestState recommendedState, ref RequestState pRequestedState, ref bool fCancel)
1570 {
1571 PlanRelatedBundleEventArgs args = new PlanRelatedBundleEventArgs(wzBundleId, recommendedState, pRequestedState, fCancel);
1572 this.OnPlanRelatedBundle(args);
1573
1574 pRequestedState = args.State;
1575 fCancel = args.Cancel;
1576 return args.HResult;
1577 }
1578
1579 int IBootstrapperApplication.OnPlanRelatedBundleType(string wzBundleId, RelatedBundlePlanType recommendedType, ref RelatedBundlePlanType pRequestedType, ref bool fCancel)
1580 {
1581 PlanRelatedBundleTypeEventArgs args = new PlanRelatedBundleTypeEventArgs(wzBundleId, recommendedType, pRequestedType, fCancel);
1582 this.OnPlanRelatedBundleType(args);
1583
1584 pRequestedType = args.Type;
1585 fCancel = args.Cancel;
1586 return args.HResult;
1587 }
1588
1589 int IBootstrapperApplication.OnPlanRollbackBoundary(string wzRollbackBoundaryId, bool fRecommendedTransaction, ref bool fTransaction, ref bool fCancel)
1590 {
1591 PlanRollbackBoundaryEventArgs args = new PlanRollbackBoundaryEventArgs(wzRollbackBoundaryId, fRecommendedTransaction, fTransaction, fCancel);
1592 this.OnPlanRollbackBoundary(args);
1593
1594 fTransaction = args.Transaction;
1595 fCancel = args.Cancel;
1596 return args.HResult;
1597 }
1598
1599 int IBootstrapperApplication.OnPlanPackageBegin(string wzPackageId, PackageState state, bool fCached, BOOTSTRAPPER_PACKAGE_CONDITION_RESULT installCondition, BOOTSTRAPPER_PACKAGE_CONDITION_RESULT repairCondition, RequestState recommendedState, BOOTSTRAPPER_CACHE_TYPE recommendedCacheType, ref RequestState pRequestedState, ref BOOTSTRAPPER_CACHE_TYPE pRequestedCacheType, ref bool fCancel)
1600 {
1601 PlanPackageBeginEventArgs args = new PlanPackageBeginEventArgs(wzPackageId, state, fCached, installCondition, repairCondition, recommendedState, recommendedCacheType, pRequestedState, pRequestedCacheType, fCancel);
1602 this.OnPlanPackageBegin(args);
1603
1604 pRequestedState = args.State;
1605 pRequestedCacheType = args.CacheType;
1606 fCancel = args.Cancel;
1607 return args.HResult;
1608 }
1609
1610 int IBootstrapperApplication.OnPlanCompatibleMsiPackageBegin(string wzPackageId, string wzCompatiblePackageId, string wzCompatiblePackageVersion, bool recommendedRemove, ref bool pRequestedRemove, ref bool fCancel)
1611 {
1612 PlanCompatibleMsiPackageBeginEventArgs args = new PlanCompatibleMsiPackageBeginEventArgs(wzPackageId, wzCompatiblePackageId, wzCompatiblePackageVersion, recommendedRemove, pRequestedRemove, fCancel);
1613 this.OnPlanCompatibleMsiPackageBegin(args);
1614
1615 pRequestedRemove = args.RequestRemove;
1616 fCancel = args.Cancel;
1617 return args.HResult;
1618 }
1619
1620 int IBootstrapperApplication.OnPlanCompatibleMsiPackageComplete(string wzPackageId, string wzCompatiblePackageId, int hrStatus, bool requestedRemove)
1621 {
1622 PlanCompatibleMsiPackageCompleteEventArgs args = new PlanCompatibleMsiPackageCompleteEventArgs(wzPackageId, wzCompatiblePackageId, hrStatus, requestedRemove);
1623 this.OnPlanCompatibleMsiPackageComplete(args);
1624
1625 return args.HResult;
1626 }
1627
1628 int IBootstrapperApplication.OnPlanPatchTarget(string wzPackageId, string wzProductCode, RequestState recommendedState, ref RequestState pRequestedState, ref bool fCancel)
1629 {
1630 PlanPatchTargetEventArgs args = new PlanPatchTargetEventArgs(wzPackageId, wzProductCode, recommendedState, pRequestedState, fCancel);
1631 this.OnPlanPatchTarget(args);
1632
1633 pRequestedState = args.State;
1634 fCancel = args.Cancel;
1635 return args.HResult;
1636 }
1637
1638 int IBootstrapperApplication.OnPlanMsiFeature(string wzPackageId, string wzFeatureId, FeatureState recommendedState, ref FeatureState pRequestedState, ref bool fCancel)
1639 {
1640 PlanMsiFeatureEventArgs args = new PlanMsiFeatureEventArgs(wzPackageId, wzFeatureId, recommendedState, pRequestedState, fCancel);
1641 this.OnPlanMsiFeature(args);
1642
1643 pRequestedState = args.State;
1644 fCancel = args.Cancel;
1645 return args.HResult;
1646 }
1647
1648 int IBootstrapperApplication.OnPlanMsiPackage(string wzPackageId, bool fExecute, ActionState action, BOOTSTRAPPER_MSI_FILE_VERSIONING recommendedFileVersioning, ref bool fCancel, ref BURN_MSI_PROPERTY actionMsiProperty, ref INSTALLUILEVEL uiLevel, ref bool fDisableExternalUiHandler, ref BOOTSTRAPPER_MSI_FILE_VERSIONING fileVersioning)
1649 {
1650 PlanMsiPackageEventArgs args = new PlanMsiPackageEventArgs(wzPackageId, fExecute, action, recommendedFileVersioning, fCancel, actionMsiProperty, uiLevel, fDisableExternalUiHandler, fileVersioning);
1651 this.OnPlanMsiPackage(args);
1652
1653 fCancel = args.Cancel;
1654 actionMsiProperty = args.ActionMsiProperty;
1655 uiLevel = args.UiLevel;
1656 fDisableExternalUiHandler = args.DisableExternalUiHandler;
1657 fileVersioning = args.FileVersioning;
1658 return args.HResult;
1659 }
1660
1661 int IBootstrapperApplication.OnPlanPackageComplete(string wzPackageId, int hrStatus, RequestState requested)
1662 {
1663 var args = new PlanPackageCompleteEventArgs(wzPackageId, hrStatus, requested);
1664 this.OnPlanPackageComplete(args);
1665
1666 return args.HResult;
1667 }
1668
1669 int IBootstrapperApplication.OnPlannedCompatiblePackage(string wzPackageId, string wzCompatiblePackageId, bool remove)
1670 {
1671 var args = new PlannedCompatiblePackageEventArgs(wzPackageId, wzCompatiblePackageId, remove);
1672 this.OnPlannedCompatiblePackage(args);
1673
1674 return args.HResult;
1675 }
1676
1677 int IBootstrapperApplication.OnPlannedPackage(string wzPackageId, ActionState execute, ActionState rollback, bool fPlannedCache, bool fPlannedUncache)
1678 {
1679 var args = new PlannedPackageEventArgs(wzPackageId, execute, rollback, fPlannedCache, fPlannedUncache);
1680 this.OnPlannedPackage(args);
1681
1682 return args.HResult;
1683 }
1684
1685 int IBootstrapperApplication.OnPlanComplete(int hrStatus)
1686 {
1687 PlanCompleteEventArgs args = new PlanCompleteEventArgs(hrStatus);
1688 this.OnPlanComplete(args);
1689
1690 return args.HResult;
1691 }
1692
1693 int IBootstrapperApplication.OnApplyBegin(int dwPhaseCount, ref bool fCancel)
1694 {
1695 ApplyBeginEventArgs args = new ApplyBeginEventArgs(dwPhaseCount, fCancel);
1696 this.OnApplyBegin(args);
1697
1698 fCancel = args.Cancel;
1699 return args.HResult;
1700 }
1701
1702 int IBootstrapperApplication.OnElevateBegin(ref bool fCancel)
1703 {
1704 ElevateBeginEventArgs args = new ElevateBeginEventArgs(fCancel);
1705 this.OnElevateBegin(args);
1706
1707 fCancel = args.Cancel;
1708 return args.HResult;
1709 }
1710
1711 int IBootstrapperApplication.OnElevateComplete(int hrStatus)
1712 {
1713 ElevateCompleteEventArgs args = new ElevateCompleteEventArgs(hrStatus);
1714 this.OnElevateComplete(args);
1715
1716 return args.HResult;
1717 }
1718
1719 int IBootstrapperApplication.OnProgress(int dwProgressPercentage, int dwOverallPercentage, ref bool fCancel)
1720 {
1721 ProgressEventArgs args = new ProgressEventArgs(dwProgressPercentage, dwOverallPercentage, fCancel);
1722 this.OnProgress(args);
1723
1724 fCancel = args.Cancel;
1725 return args.HResult;
1726 }
1727
1728 int IBootstrapperApplication.OnError(ErrorType errorType, string wzPackageId, int dwCode, string wzError, int dwUIHint, int cData, string[] rgwzData, Result nRecommendation, ref Result pResult)
1729 {
1730 ErrorEventArgs args = new ErrorEventArgs(errorType, wzPackageId, dwCode, wzError, dwUIHint, rgwzData, nRecommendation, pResult);
1731 this.OnError(args);
1732
1733 pResult = args.Result;
1734 return args.HResult;
1735 }
1736
1737 int IBootstrapperApplication.OnRegisterBegin(RegistrationType recommendedRegistrationType, ref bool fCancel, ref RegistrationType registrationType)
1738 {
1739 RegisterBeginEventArgs args = new RegisterBeginEventArgs(recommendedRegistrationType, fCancel, registrationType);
1740 this.OnRegisterBegin(args);
1741
1742 fCancel = args.Cancel;
1743 registrationType = args.RegistrationType;
1744 return args.HResult;
1745 }
1746
1747 int IBootstrapperApplication.OnRegisterComplete(int hrStatus)
1748 {
1749 RegisterCompleteEventArgs args = new RegisterCompleteEventArgs(hrStatus);
1750 this.OnRegisterComplete(args);
1751
1752 return args.HResult;
1753 }
1754
1755 int IBootstrapperApplication.OnCacheBegin(ref bool fCancel)
1756 {
1757 CacheBeginEventArgs args = new CacheBeginEventArgs(fCancel);
1758 this.OnCacheBegin(args);
1759
1760 fCancel = args.Cancel;
1761 return args.HResult;
1762 }
1763
1764 int IBootstrapperApplication.OnCachePackageBegin(string wzPackageId, int cCachePayloads, long dw64PackageCacheSize, bool fVital, ref bool fCancel)
1765 {
1766 CachePackageBeginEventArgs args = new CachePackageBeginEventArgs(wzPackageId, cCachePayloads, dw64PackageCacheSize, fVital, fCancel);
1767 this.OnCachePackageBegin(args);
1768
1769 fCancel = args.Cancel;
1770 return args.HResult;
1771 }
1772
1773 int IBootstrapperApplication.OnCacheAcquireBegin(string wzPackageOrContainerId, string wzPayloadId, string wzSource, string wzDownloadUrl, string wzPayloadContainerId, CacheOperation recommendation, ref CacheOperation action, ref bool fCancel)
1774 {
1775 CacheAcquireBeginEventArgs args = new CacheAcquireBeginEventArgs(wzPackageOrContainerId, wzPayloadId, wzSource, wzDownloadUrl, wzPayloadContainerId, recommendation, action, fCancel);
1776 this.OnCacheAcquireBegin(args);
1777
1778 action = args.Action;
1779 fCancel = args.Cancel;
1780 return args.HResult;
1781 }
1782
1783 int IBootstrapperApplication.OnCacheAcquireProgress(string wzPackageOrContainerId, string wzPayloadId, long dw64Progress, long dw64Total, int dwOverallPercentage, ref bool fCancel)
1784 {
1785 CacheAcquireProgressEventArgs args = new CacheAcquireProgressEventArgs(wzPackageOrContainerId, wzPayloadId, dw64Progress, dw64Total, dwOverallPercentage, fCancel);
1786 this.OnCacheAcquireProgress(args);
1787
1788 fCancel = args.Cancel;
1789 return args.HResult;
1790 }
1791
1792 int IBootstrapperApplication.OnCacheAcquireResolving(string wzPackageOrContainerId, string wzPayloadId, string[] searchPaths, int cSearchPaths, bool fFoundLocal, int dwRecommendedSearchPath, string wzDownloadUrl, string wzPayloadContainerId, CacheResolveOperation recommendation, ref int dwChosenSearchPath, ref CacheResolveOperation action, ref bool fCancel)
1793 {
1794 CacheAcquireResolvingEventArgs args = new CacheAcquireResolvingEventArgs(wzPackageOrContainerId, wzPayloadId, searchPaths, fFoundLocal, dwRecommendedSearchPath, wzDownloadUrl, wzPayloadContainerId, recommendation, dwChosenSearchPath, action, fCancel);
1795 this.OnCacheAcquireResolving(args);
1796
1797 dwChosenSearchPath = args.ChosenSearchPath;
1798 action = args.Action;
1799 fCancel = args.Cancel;
1800 return args.HResult;
1801 }
1802
1803 int IBootstrapperApplication.OnCacheAcquireComplete(string wzPackageOrContainerId, string wzPayloadId, int hrStatus, BOOTSTRAPPER_CACHEACQUIRECOMPLETE_ACTION recommendation, ref BOOTSTRAPPER_CACHEACQUIRECOMPLETE_ACTION action)
1804 {
1805 CacheAcquireCompleteEventArgs args = new CacheAcquireCompleteEventArgs(wzPackageOrContainerId, wzPayloadId, hrStatus, recommendation, action);
1806 this.OnCacheAcquireComplete(args);
1807
1808 action = args.Action;
1809 return args.HResult;
1810 }
1811
1812 int IBootstrapperApplication.OnCacheVerifyBegin(string wzPackageOrContainerId, string wzPayloadId, ref bool fCancel)
1813 {
1814 CacheVerifyBeginEventArgs args = new CacheVerifyBeginEventArgs(wzPackageOrContainerId, wzPayloadId, fCancel);
1815 this.OnCacheVerifyBegin(args);
1816
1817 fCancel = args.Cancel;
1818 return args.HResult;
1819 }
1820
1821 int IBootstrapperApplication.OnCacheVerifyProgress(string wzPackageOrContainerId, string wzPayloadId, long dw64Progress, long dw64Total, int dwOverallPercentage, CacheVerifyStep verifyStep, ref bool fCancel)
1822 {
1823 CacheVerifyProgressEventArgs args = new CacheVerifyProgressEventArgs(wzPackageOrContainerId, wzPayloadId, dw64Progress, dw64Total, dwOverallPercentage, verifyStep, fCancel);
1824 this.OnCacheVerifyProgress(args);
1825
1826 fCancel = args.Cancel;
1827 return args.HResult;
1828 }
1829
1830 int IBootstrapperApplication.OnCacheVerifyComplete(string wzPackageOrContainerId, string wzPayloadId, int hrStatus, BOOTSTRAPPER_CACHEVERIFYCOMPLETE_ACTION recommendation, ref BOOTSTRAPPER_CACHEVERIFYCOMPLETE_ACTION action)
1831 {
1832 CacheVerifyCompleteEventArgs args = new CacheVerifyCompleteEventArgs(wzPackageOrContainerId, wzPayloadId, hrStatus, recommendation, action);
1833 this.OnCacheVerifyComplete(args);
1834
1835 action = args.Action;
1836 return args.HResult;
1837 }
1838
1839 int IBootstrapperApplication.OnCachePackageComplete(string wzPackageId, int hrStatus, BOOTSTRAPPER_CACHEPACKAGECOMPLETE_ACTION recommendation, ref BOOTSTRAPPER_CACHEPACKAGECOMPLETE_ACTION action)
1840 {
1841 CachePackageCompleteEventArgs args = new CachePackageCompleteEventArgs(wzPackageId, hrStatus, recommendation, action);
1842 this.OnCachePackageComplete(args);
1843
1844 action = args.Action;
1845 return args.HResult;
1846 }
1847
1848 int IBootstrapperApplication.OnCacheComplete(int hrStatus)
1849 {
1850 CacheCompleteEventArgs args = new CacheCompleteEventArgs(hrStatus);
1851 this.OnCacheComplete(args);
1852
1853 return args.HResult;
1854 }
1855
1856 int IBootstrapperApplication.OnExecuteBegin(int cExecutingPackages, ref bool fCancel)
1857 {
1858 ExecuteBeginEventArgs args = new ExecuteBeginEventArgs(cExecutingPackages, fCancel);
1859 this.OnExecuteBegin(args);
1860
1861 args.Cancel = fCancel;
1862 return args.HResult;
1863 }
1864
1865 int IBootstrapperApplication.OnExecutePackageBegin(string wzPackageId, bool fExecute, ActionState action, INSTALLUILEVEL uiLevel, bool fDisableExternalUiHandler, ref bool fCancel)
1866 {
1867 ExecutePackageBeginEventArgs args = new ExecutePackageBeginEventArgs(wzPackageId, fExecute, action, uiLevel, fDisableExternalUiHandler, fCancel);
1868 this.OnExecutePackageBegin(args);
1869
1870 fCancel = args.Cancel;
1871 return args.HResult;
1872 }
1873
1874 int IBootstrapperApplication.OnExecutePatchTarget(string wzPackageId, string wzTargetProductCode, ref bool fCancel)
1875 {
1876 ExecutePatchTargetEventArgs args = new ExecutePatchTargetEventArgs(wzPackageId, wzTargetProductCode, fCancel);
1877 this.OnExecutePatchTarget(args);
1878
1879 fCancel = args.Cancel;
1880 return args.HResult;
1881 }
1882
1883 int IBootstrapperApplication.OnExecuteProgress(string wzPackageId, int dwProgressPercentage, int dwOverallPercentage, ref bool fCancel)
1884 {
1885 ExecuteProgressEventArgs args = new ExecuteProgressEventArgs(wzPackageId, dwProgressPercentage, dwOverallPercentage, fCancel);
1886 this.OnExecuteProgress(args);
1887
1888 fCancel = args.Cancel;
1889 return args.HResult;
1890 }
1891
1892 int IBootstrapperApplication.OnExecuteMsiMessage(string wzPackageId, InstallMessage messageType, int dwUIHint, string wzMessage, int cData, string[] rgwzData, Result nRecommendation, ref Result pResult)
1893 {
1894 ExecuteMsiMessageEventArgs args = new ExecuteMsiMessageEventArgs(wzPackageId, messageType, dwUIHint, wzMessage, rgwzData, nRecommendation, pResult);
1895 this.OnExecuteMsiMessage(args);
1896
1897 pResult = args.Result;
1898 return args.HResult;
1899 }
1900
1901 int IBootstrapperApplication.OnExecuteFilesInUse(string wzPackageId, int cFiles, string[] rgwzFiles, Result nRecommendation, FilesInUseType source, ref Result pResult)
1902 {
1903 ExecuteFilesInUseEventArgs args = new ExecuteFilesInUseEventArgs(wzPackageId, rgwzFiles, nRecommendation, source, pResult);
1904 this.OnExecuteFilesInUse(args);
1905
1906 pResult = args.Result;
1907 return args.HResult;
1908 }
1909
1910 int IBootstrapperApplication.OnExecutePackageComplete(string wzPackageId, int hrStatus, ApplyRestart restart, BOOTSTRAPPER_EXECUTEPACKAGECOMPLETE_ACTION recommendation, ref BOOTSTRAPPER_EXECUTEPACKAGECOMPLETE_ACTION pAction)
1911 {
1912 ExecutePackageCompleteEventArgs args = new ExecutePackageCompleteEventArgs(wzPackageId, hrStatus, restart, recommendation, pAction);
1913 this.OnExecutePackageComplete(args);
1914
1915 pAction = args.Action;
1916 return args.HResult;
1917 }
1918
1919 int IBootstrapperApplication.OnExecuteComplete(int hrStatus)
1920 {
1921 ExecuteCompleteEventArgs args = new ExecuteCompleteEventArgs(hrStatus);
1922 this.OnExecuteComplete(args);
1923
1924 return args.HResult;
1925 }
1926
1927 int IBootstrapperApplication.OnUnregisterBegin(RegistrationType recommendedRegistrationType, ref RegistrationType registrationType)
1928 {
1929 UnregisterBeginEventArgs args = new UnregisterBeginEventArgs(recommendedRegistrationType, registrationType);
1930 this.OnUnregisterBegin(args);
1931
1932 registrationType = args.RegistrationType;
1933 return args.HResult;
1934 }
1935
1936 int IBootstrapperApplication.OnUnregisterComplete(int hrStatus)
1937 {
1938 UnregisterCompleteEventArgs args = new UnregisterCompleteEventArgs(hrStatus);
1939 this.OnUnregisterComplete(args);
1940
1941 return args.HResult;
1942 }
1943
1944 int IBootstrapperApplication.OnApplyComplete(int hrStatus, ApplyRestart restart, BOOTSTRAPPER_APPLYCOMPLETE_ACTION recommendation, ref BOOTSTRAPPER_APPLYCOMPLETE_ACTION pAction)
1945 {
1946 ApplyCompleteEventArgs args = new ApplyCompleteEventArgs(hrStatus, restart, recommendation, pAction);
1947 this.OnApplyComplete(args);
1948
1949 pAction = args.Action;
1950 return args.HResult;
1951 }
1952
1953 int IBootstrapperApplication.OnApplyDowngrade(int hrRecommendation, ref int hrStatus)
1954 {
1955 ApplyDowngradeEventArgs args = new ApplyDowngradeEventArgs(hrRecommendation, hrStatus);
1956 this.OnApplyDowngrade(args);
1957
1958 hrStatus = args.Status;
1959 return args.HResult;
1960 }
1961
1962 int IBootstrapperApplication.OnLaunchApprovedExeBegin(ref bool fCancel)
1963 {
1964 LaunchApprovedExeBeginEventArgs args = new LaunchApprovedExeBeginEventArgs(fCancel);
1965 this.OnLaunchApprovedExeBegin(args);
1966
1967 fCancel = args.Cancel;
1968 return args.HResult;
1969 }
1970
1971 int IBootstrapperApplication.OnLaunchApprovedExeComplete(int hrStatus, int processId)
1972 {
1973 LaunchApprovedExeCompleteEventArgs args = new LaunchApprovedExeCompleteEventArgs(hrStatus, processId);
1974 this.OnLaunchApprovedExeComplete(args);
1975
1976 return args.HResult;
1977 }
1978
1979 int IBootstrapperApplication.OnBeginMsiTransactionBegin(string transactionId, ref bool fCancel)
1980 {
1981 BeginMsiTransactionBeginEventArgs args = new BeginMsiTransactionBeginEventArgs(transactionId, fCancel);
1982 this.OnBeginMsiTransactionBegin(args);
1983
1984 fCancel = args.Cancel;
1985 return args.HResult;
1986 }
1987
1988 int IBootstrapperApplication.OnBeginMsiTransactionComplete(string transactionId, int hrStatus)
1989 {
1990 BeginMsiTransactionCompleteEventArgs args = new BeginMsiTransactionCompleteEventArgs(transactionId, hrStatus);
1991 this.OnBeginMsiTransactionComplete(args);
1992
1993 return args.HResult;
1994 }
1995
1996 int IBootstrapperApplication.OnCommitMsiTransactionBegin(string transactionId, ref bool fCancel)
1997 {
1998 CommitMsiTransactionBeginEventArgs args = new CommitMsiTransactionBeginEventArgs(transactionId, fCancel);
1999 this.OnCommitMsiTransactionBegin(args);
2000
2001 fCancel = args.Cancel;
2002 return args.HResult;
2003 }
2004
2005 int IBootstrapperApplication.OnCommitMsiTransactionComplete(string transactionId, int hrStatus, ApplyRestart restart, BOOTSTRAPPER_EXECUTEMSITRANSACTIONCOMPLETE_ACTION recommendation, ref BOOTSTRAPPER_EXECUTEMSITRANSACTIONCOMPLETE_ACTION pAction)
2006 {
2007 CommitMsiTransactionCompleteEventArgs args = new CommitMsiTransactionCompleteEventArgs(transactionId, hrStatus, restart, recommendation, pAction);
2008 this.OnCommitMsiTransactionComplete(args);
2009
2010 pAction = args.Action;
2011 return args.HResult;
2012 }
2013
2014 int IBootstrapperApplication.OnRollbackMsiTransactionBegin(string transactionId)
2015 {
2016 RollbackMsiTransactionBeginEventArgs args = new RollbackMsiTransactionBeginEventArgs(transactionId);
2017 this.OnRollbackMsiTransactionBegin(args);
2018
2019 return args.HResult;
2020 }
2021
2022 int IBootstrapperApplication.OnRollbackMsiTransactionComplete(string transactionId, int hrStatus, ApplyRestart restart, BOOTSTRAPPER_EXECUTEMSITRANSACTIONCOMPLETE_ACTION recommendation, ref BOOTSTRAPPER_EXECUTEMSITRANSACTIONCOMPLETE_ACTION pAction)
2023 {
2024 RollbackMsiTransactionCompleteEventArgs args = new RollbackMsiTransactionCompleteEventArgs(transactionId, hrStatus, restart, recommendation, pAction);
2025 this.OnRollbackMsiTransactionComplete(args);
2026
2027 pAction = args.Action;
2028 return args.HResult;
2029 }
2030
2031 int IBootstrapperApplication.OnPauseAutomaticUpdatesBegin()
2032 {
2033 PauseAutomaticUpdatesBeginEventArgs args = new PauseAutomaticUpdatesBeginEventArgs();
2034 this.OnPauseAutomaticUpdatesBegin(args);
2035
2036 return args.HResult;
2037 }
2038
2039 int IBootstrapperApplication.OnPauseAutomaticUpdatesComplete(int hrStatus)
2040 {
2041 PauseAutomaticUpdatesCompleteEventArgs args = new PauseAutomaticUpdatesCompleteEventArgs(hrStatus);
2042 this.OnPauseAutomaticUpdatesComplete(args);
2043
2044 return args.HResult;
2045 }
2046
2047 int IBootstrapperApplication.OnSystemRestorePointBegin()
2048 {
2049 SystemRestorePointBeginEventArgs args = new SystemRestorePointBeginEventArgs();
2050 this.OnSystemRestorePointBegin(args);
2051
2052 return args.HResult;
2053 }
2054
2055 int IBootstrapperApplication.OnSystemRestorePointComplete(int hrStatus)
2056 {
2057 SystemRestorePointCompleteEventArgs args = new SystemRestorePointCompleteEventArgs(hrStatus);
2058 this.OnSystemRestorePointComplete(args);
2059
2060 return args.HResult;
2061 }
2062
2063 int IBootstrapperApplication.OnPlanForwardCompatibleBundle(string wzBundleId, RelationType relationType, string wzBundleTag, bool fPerMachine, string wzVersion, bool fRecommendedIgnoreBundle, ref bool fCancel, ref bool fIgnoreBundle)
2064 {
2065 PlanForwardCompatibleBundleEventArgs args = new PlanForwardCompatibleBundleEventArgs(wzBundleId, relationType, wzBundleTag, fPerMachine, wzVersion, fRecommendedIgnoreBundle, fCancel, fIgnoreBundle);
2066 this.OnPlanForwardCompatibleBundle(args);
2067
2068 fCancel = args.Cancel;
2069 fIgnoreBundle = args.IgnoreBundle;
2070 return args.HResult;
2071 }
2072
2073 int IBootstrapperApplication.OnCacheContainerOrPayloadVerifyBegin(string wzPackageOrContainerId, string wzPayloadId, ref bool fCancel)
2074 {
2075 CacheContainerOrPayloadVerifyBeginEventArgs args = new CacheContainerOrPayloadVerifyBeginEventArgs(wzPackageOrContainerId, wzPayloadId, fCancel);
2076 this.OnCacheContainerOrPayloadVerifyBegin(args);
2077
2078 fCancel = args.Cancel;
2079 return args.HResult;
2080 }
2081
2082 int IBootstrapperApplication.OnCacheContainerOrPayloadVerifyProgress(string wzPackageOrContainerId, string wzPayloadId, long dw64Progress, long dw64Total, int dwOverallPercentage, ref bool fCancel)
2083 {
2084 CacheContainerOrPayloadVerifyProgressEventArgs args = new CacheContainerOrPayloadVerifyProgressEventArgs(wzPackageOrContainerId, wzPayloadId, dw64Progress, dw64Total, dwOverallPercentage, fCancel);
2085 this.OnCacheContainerOrPayloadVerifyProgress(args);
2086
2087 fCancel = args.Cancel;
2088 return args.HResult;
2089 }
2090
2091 int IBootstrapperApplication.OnCacheContainerOrPayloadVerifyComplete(string wzPackageOrContainerId, string wzPayloadId, int hrStatus)
2092 {
2093 CacheContainerOrPayloadVerifyCompleteEventArgs args = new CacheContainerOrPayloadVerifyCompleteEventArgs(wzPackageOrContainerId, wzPayloadId, hrStatus);
2094 this.OnCacheContainerOrPayloadVerifyComplete(args);
2095
2096 return args.HResult;
2097 }
2098
2099 int IBootstrapperApplication.OnCachePayloadExtractBegin(string wzContainerId, string wzPayloadId, ref bool fCancel)
2100 {
2101 CachePayloadExtractBeginEventArgs args = new CachePayloadExtractBeginEventArgs(wzContainerId, wzPayloadId, fCancel);
2102 this.OnCachePayloadExtractBegin(args);
2103
2104 fCancel = args.Cancel;
2105 return args.HResult;
2106 }
2107
2108 int IBootstrapperApplication.OnCachePayloadExtractProgress(string wzContainerId, string wzPayloadId, long dw64Progress, long dw64Total, int dwOverallPercentage, ref bool fCancel)
2109 {
2110 CachePayloadExtractProgressEventArgs args = new CachePayloadExtractProgressEventArgs(wzContainerId, wzPayloadId, dw64Progress, dw64Total, dwOverallPercentage, fCancel);
2111 this.OnCachePayloadExtractProgress(args);
2112
2113 fCancel = args.Cancel;
2114 return args.HResult;
2115 }
2116
2117 int IBootstrapperApplication.OnCachePayloadExtractComplete(string wzContainerId, string wzPayloadId, int hrStatus)
2118 {
2119 CachePayloadExtractCompleteEventArgs args = new CachePayloadExtractCompleteEventArgs(wzContainerId, wzPayloadId, hrStatus);
2120 this.OnCachePayloadExtractComplete(args);
2121
2122 return args.HResult;
2123 }
2124
2125 int IBootstrapperApplication.OnPlanRestoreRelatedBundle(string wzBundleId, RequestState recommendedState, ref RequestState pRequestedState, ref bool fCancel)
2126 {
2127 PlanRestoreRelatedBundleEventArgs args = new PlanRestoreRelatedBundleEventArgs(wzBundleId, recommendedState, pRequestedState, fCancel);
2128 this.OnPlanRestoreRelatedBundle(args);
2129
2130 pRequestedState = args.State;
2131 fCancel = args.Cancel;
2132 return args.HResult;
2133 }
2134
2135 int IBootstrapperApplication.OnExecuteProcessCancel(string wzPackageId, int processId, BOOTSTRAPPER_EXECUTEPROCESSCANCEL_ACTION recommendation, ref BOOTSTRAPPER_EXECUTEPROCESSCANCEL_ACTION pAction)
2136 {
2137 ExecuteProcessCancelEventArgs args = new ExecuteProcessCancelEventArgs(wzPackageId, processId, recommendation, pAction);
2138 this.OnExecuteProcessCancel(args);
2139
2140 pAction = args.Action;
2141 return args.HResult;
2142 }
2143
2144 int IBootstrapperApplication.OnDetectRelatedBundlePackage(string wzPackageId, string wzProductCode, RelationType relationType, bool fPerMachine, string wzVersion, ref bool fCancel)
2145 {
2146 DetectRelatedBundlePackageEventArgs args = new DetectRelatedBundlePackageEventArgs(wzPackageId, wzProductCode, relationType, fPerMachine, wzVersion, fCancel);
2147 this.OnDetectRelatedBundlePackage(args);
2148
2149 fCancel = args.Cancel;
2150 return args.HResult;
2151 }
2152
2153 int IBootstrapperApplication.OnCachePackageNonVitalValidationFailure(string wzPackageId, int hrStatus, BOOTSTRAPPER_CACHEPACKAGENONVITALVALIDATIONFAILURE_ACTION recommendation, ref BOOTSTRAPPER_CACHEPACKAGENONVITALVALIDATIONFAILURE_ACTION action)
2154 {
2155 CachePackageNonVitalValidationFailureEventArgs args = new CachePackageNonVitalValidationFailureEventArgs(wzPackageId, hrStatus, recommendation, action);
2156 this.OnCachePackageNonVitalValidationFailure(args);
2157
2158 action = args.Action;
2159 return args.HResult;
2160 }
2161
2162 #endregion
2163 }
2164 }