include: Add some __RPC_XXX macros to help compile code using midl-generated headers.
[wine] / include / wuapi.idl
1 /*
2  * Copyright 2008 Hans Leidekker for CodeWeavers
3  *
4  * This library is free software; you can redistribute it and/or
5  * modify it under the terms of the GNU Lesser General Public
6  * License as published by the Free Software Foundation; either
7  * version 2.1 of the License, or (at your option) any later version.
8  *
9  * This library is distributed in the hope that it will be useful,
10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
12  * Lesser General Public License for more details.
13  *
14  * You should have received a copy of the GNU Lesser General Public
15  * License along with this library; if not, write to the Free Software
16  * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
17  */
18
19 import "oaidl.idl";
20
21 #ifndef __WIDL__
22 #define threading(model)
23 #define progid(str)
24 #define vi_progid(str)
25 #endif
26
27 [
28     helpstring("WUAPI 2.0 Type Library"),
29     uuid(b596cc9f-56e5-419e-a622-e01bb457431e),
30     version(2.0)
31 ]
32 library WUApiLib {
33
34 importlib("stdole2.tlb");
35
36 interface ICategoryCollection;
37 interface IStringCollection;
38 interface IUpdateCollection;
39 interface IUpdateDownloader;
40 interface IUpdateInstaller;
41 interface IUpdateSearcher;
42
43 typedef [public] enum tagDownloadPriority
44 {
45     dpLow    = 1,
46     dpNormal = 2,
47     dpHigh   = 3,
48 } DownloadPriority;
49
50 typedef [public] enum tagServerSelection
51 {
52     ssDefault       = 0,
53     ssManagedServer = 1,
54     ssWindowsUpdate = 2,
55     ssOthers        = 3,
56 } ServerSelection;
57
58 typedef [public] enum tagAutomaticUpdatesNotificationLevel
59 {
60     aunlNotConfigured,
61     aunlDisabled,
62     aunlNotifyBeforeDownload,
63     aunlNotifyBeforeInstallation,
64     aunlScheduledInstallation,
65 } AutomaticUpdatesNotificationLevel;
66
67 typedef [public] enum tagAutomaticUpdatesScheduledInstallationDay
68 {
69     ausidEveryDay,
70     ausidEverySunday,
71     ausidEveryMonday,
72     ausidEveryTuesday,
73     ausidEveryWednesday,
74     ausidEveryThursday,
75     ausidEveryFriday,
76     ausidEverySaturday,
77 } AutomaticUpdatesScheduledInstallationDay;
78
79 typedef [public] enum tagDownloadPhase
80 {
81     dphInitializing,
82     dphDownloading,
83     dphVerifying,
84 } DownloadPhase;
85
86 typedef [public] enum tagOperationResultCode
87 {
88     orcNotStarted,
89     orcInProgress,
90     orcSucceeded,
91     orcSucceededWithErrors,
92     orcFailed,
93     orcAborted,
94 } OperationResultCode;
95
96 typedef [public] enum tagUpdateExceptionContext
97 {
98     uecGeneral = 1,
99     uecWindowsDriver,
100     uecWindowsInstaller
101 } UpdateExceptionContext;
102
103 typedef [public] enum tagInstallationImpact
104 {
105     iiNormal,
106     iiMinor,
107     iiRequiresExclusiveHandling
108 } InstallationImpact;
109
110 typedef [public] enum tagInstallationRebootBehavior
111 {
112     irbNeverReboots,
113     irbAlwaysRequiresReboot,
114     irbCanRequestReboot
115 } InstallationRebootBehavior;
116
117 typedef [public] enum tagUpdateType
118 {
119     utSoftware = 1,
120     utDriver
121 } UpdateType;
122
123 typedef [public] enum tagUpdateOperation
124 {
125     uoInstallation = 1,
126     uoUninstallation
127 } UpdateOperation;
128
129 typedef [public] enum tagDeploymentAction
130 {
131     daNone,
132     daInstallation,
133     daUninstallation,
134     daDetection
135 } DeploymentAction;
136
137 [
138     object,
139     oleautomation,
140     dual,
141     nonextensible,
142     uuid(2ee48f22-af3c-405f-8970-f71be12ee9a2),
143     pointer_default(unique)
144 ]
145 interface IAutomaticUpdatesSettings : IDispatch
146 {
147     [propget, id(0x60020001)]
148     HRESULT NotificationLevel( [out, retval] AutomaticUpdatesNotificationLevel *retval );
149
150     [propput, id(0x60020001)]
151     HRESULT NotificationLevel( [in] AutomaticUpdatesNotificationLevel value );
152
153     [propget, id(0x60020002)]
154     HRESULT ReadOnly( [out, retval] VARIANT_BOOL *retval );
155
156     [propget, id(0x60020003)]
157     HRESULT Required( [out, retval] VARIANT_BOOL *retval );
158
159     [propget, id(0x60020004)]
160     HRESULT ScheduledInstallationDay( [out, retval] AutomaticUpdatesScheduledInstallationDay *retval );
161
162     [propput, id(0x60020004)]
163     HRESULT ScheduledInstallationDay( [in] AutomaticUpdatesScheduledInstallationDay value );
164
165     [propget, id(0x60020005)]
166     HRESULT ScheduledInstallationTime( [out, retval] LONG *retval );
167
168     [propput, id(0x60020005)]
169     HRESULT ScheduledInstallationTime( [in] LONG value );
170
171     [id(0x60020006)]
172     HRESULT Refresh();
173
174     [id(0x60020007)]
175     HRESULT Save();
176 }
177
178 [
179     object,
180     uuid(673425bf-c082-4c7c-bdfd-569464b8e0ce),
181     oleautomation,
182     dual,
183     nonextensible,
184     pointer_default(unique),
185     hidden
186 ]
187 interface IAutomaticUpdates : IDispatch
188 {
189     HRESULT DetectNow();
190     HRESULT Pause();
191     HRESULT Resume();
192     HRESULT ShowSettingsDialog();
193
194     [propget]
195     HRESULT Settings(
196         [out, retval] IAutomaticUpdatesSettings **retval);
197
198     [propget]
199     HRESULT ServiceEnabled(
200         [out, retval] VARIANT_BOOL *retval);
201
202     HRESULT EnableService();
203 }
204
205 [
206     object,
207     oleautomation,
208     dual,
209     nonextensible,
210     uuid(174c81fe-aecd-4dae-b8a0-2c6318dd86a8),
211     pointer_default(unique),
212 ]
213 interface IWebProxy : IDispatch
214 {
215     [propget, id(0x60020001)]
216     HRESULT Address( [out, retval] BSTR *retval );
217
218     [propput, id(0x60020001)]
219     HRESULT Address( [in] BSTR value );
220
221     [propget, id(0x60020002)]
222     HRESULT BypassList( [out, retval] IStringCollection **retval );
223
224     [propput, id(0x60020002)]
225     HRESULT BypassList( [in] IStringCollection *value );
226
227     [propget, id(0x60020003)]
228     HRESULT BypassProxyOnLocal( [out, retval] VARIANT_BOOL *retval );
229
230     [propput, id(0x60020003)]
231     HRESULT BypassProxyOnLocal( [in] VARIANT_BOOL value );
232
233     [propget, id(0x60020004)]
234     HRESULT ReadOnly( [out, retval] VARIANT_BOOL *retval );
235
236     [propget, id(0x60020005)]
237     HRESULT UserName( [out, retval] BSTR *retval );
238
239     [propput, id(0x60020005)]
240     HRESULT UserName( [in] BSTR value );
241
242     [id(0x60020006)]
243     HRESULT SetPassword( [in] BSTR value );
244
245     [id(0x60020007)]
246     HRESULT PromptForCredentials( [in, unique] IUnknown *parentWindow,
247                                   [in] BSTR title );
248
249     [restricted, id(0x60020008)]
250     HRESULT PromptForCredentialsFromHwnd( [in, unique] HWND parentWindow,
251                                           [in] BSTR title );
252
253     [propget, id(0x60020009)]
254     HRESULT AutoDetect( [out, retval] VARIANT_BOOL *retval );
255
256     [propput, id(0x60020009)]
257     HRESULT AutoDetect( [in] VARIANT_BOOL value );
258 }
259
260 [
261     object,
262     uuid(816858a4-260d-4260-933a-2585f1abc76b),
263     oleautomation,
264     dual,
265     nonextensible,
266     pointer_default(unique),
267 ]
268 interface IUpdateSession : IDispatch
269 {
270     [propget]
271     HRESULT ClientApplicationID(
272         [out, retval] BSTR *retval);
273
274     [propput]
275     HRESULT ClientApplicationID(
276         [in] BSTR value);
277
278     [propget]
279     HRESULT ReadOnly(
280         [out, retval] VARIANT_BOOL *retval);
281
282     [propget]
283     HRESULT WebProxy(
284         [out, retval] IWebProxy **retval);
285
286     [propput]
287     HRESULT WebProxy(
288         [in, unique] IWebProxy *value);
289
290     HRESULT CreateUpdateSearcher(
291         [out, retval] IUpdateSearcher **retval);
292
293     HRESULT CreateUpdateDownloader(
294         [out, retval] IUpdateDownloader **retval);
295
296     HRESULT CreateUpdateInstaller(
297         [out, retval] IUpdateInstaller **retval);
298 }
299
300 [
301     object,
302     oleautomation,
303     dual,
304     nonextensible,
305     uuid(7c907864-346c-4aeb-8f3f-57da289f969f),
306     pointer_default(unique),
307 ]
308 interface IImageInformation : IDispatch
309 {
310     [propget, id(0x60020001)]
311     HRESULT AltText( [out, retval] BSTR *retval );
312
313     [propget, id(0x60020002)]
314     HRESULT Height( [out, retval] LONG *retval );
315
316     [propget, id(0x60020003)]
317     HRESULT Source( [out, retval] BSTR *retval );
318
319     [propget, id(0x60020004)]
320     HRESULT Width( [out, retval] LONG *retval );
321 }
322
323 [
324     object,
325     oleautomation,
326     dual,
327     nonextensible,
328     uuid(81ddc1b8-9d35-47a6-b471-5b80f519223b),
329     pointer_default(unique),
330 ]
331 interface ICategory : IDispatch
332 {
333     [propget, id(DISPID_VALUE)]
334     HRESULT Name( [out, retval] BSTR *retval );
335
336     [propget, id(0x60020001)]
337     HRESULT CategoryID( [out, retval] BSTR *retval );
338
339     [propget, id(0x60020002)]
340     HRESULT Children( [out, retval] ICategoryCollection **retval );
341
342     [propget, id(0x60020003)]
343     HRESULT Description( [out, retval] BSTR *retval );
344
345     [propget, id(0x60020004)]
346     HRESULT Image( [out, retval] IImageInformation **retval );
347
348     [propget, id(0x60020005)]
349     HRESULT Order( [out, retval] LONG *retval );
350
351     [propget, id(0x60020006)]
352     HRESULT Parent( [out, retval] ICategory **retval );
353
354     [propget, id(0x60020007)]
355     HRESULT Type( [out, retval] BSTR *retval );
356
357     [propget, id(0x60020008)]
358     HRESULT Updates( [out, retval] IUpdateCollection **retval );
359 }
360
361 [
362     object,
363     oleautomation,
364     dual,
365     nonextensible,
366     uuid(3a56bfb8-576c-43f7-9335-fe4838fd7e37),
367     pointer_default(unique),
368 ]
369 interface ICategoryCollection : IDispatch
370 {
371     [propget, id(DISPID_VALUE)]
372     HRESULT Item( [in] LONG index,
373                 [out, retval] ICategory **retval );
374
375     [propget, id(DISPID_NEWENUM)]
376     HRESULT _NewEnum( [out, retval] IUnknown **retval );
377
378     [propget, id(0x60020001)]
379     HRESULT Count( [out, retval] LONG *retval );
380 }
381
382 [
383     object,
384     oleautomation,
385     dual,
386     nonextensible,
387     uuid(eff90582-2ddc-480f-a06d-60f3fbc362c3),
388     pointer_default(unique),
389     hidden
390 ]
391 interface IStringCollection : IDispatch
392 {
393     [propget, id(DISPID_VALUE)]
394     HRESULT Item( [in] LONG index,
395                   [out, retval] BSTR *retval );
396
397     [propput, id(DISPID_VALUE)]
398     HRESULT Item( [in] LONG index,
399                 [in] BSTR value );
400
401     [propget, id(DISPID_NEWENUM)]
402     HRESULT _NewEnum( [out, retval] IUnknown **retval );
403
404     [propget, id(0x60020001)]
405     HRESULT Count( [out, retval] LONG *retval );
406
407     [propget, id(0x60020002)]
408     HRESULT ReadOnly( [out, retval] VARIANT_BOOL *retval );
409
410     [id(0x60020003)]
411     HRESULT Add( [in] BSTR value,
412                  [out, retval] LONG *retval );
413
414     [id(0x60020004)]
415     HRESULT Clear();
416
417     [id(0x60020005)]
418     HRESULT Copy( [out, retval] IStringCollection **retval );
419
420     [id(0x60020006)]
421     HRESULT Insert( [in] LONG index,
422                     [in] BSTR value );
423
424     [id(0x60020007)]
425     HRESULT RemoveAt( [in] LONG index );
426 }
427
428 [
429     object,
430     oleautomation,
431     dual,
432     nonextensible,
433     uuid(a376dd5e-09d4-427f-af7c-fed5b6e1c1d6),
434     pointer_default(unique),
435 ]
436 interface IUpdateException : IDispatch
437 {
438     [propget, id(DISPID_VALUE)]
439     HRESULT Message( [out, retval] BSTR *retval );
440
441     [propget, id(0x60020001)]
442     HRESULT HResult( [out, retval] LONG *retval );
443
444     [propget, id(0x60020002)]
445     HRESULT Context( [out, retval] UpdateExceptionContext *retval );
446 }
447
448 [
449     object,
450     oleautomation,
451     dual,
452     nonextensible,
453     uuid(503626a3-8e14-4729-9355-0fe664bd2321),
454     pointer_default(unique),
455 ]
456 interface IUpdateExceptionCollection : IDispatch
457 {
458     [propget, id(DISPID_VALUE)]
459     HRESULT Item( [in] LONG index,
460                   [out, retval] IUpdateException **retval );
461
462     [propget, id(DISPID_NEWENUM)]
463     HRESULT _NewEnum( [out, retval] IUnknown **retval );
464
465     [propget, id(0x60020001)]
466     HRESULT Count( [out, retval] LONG *retval );
467 }
468
469 [
470     object,
471     oleautomation,
472     dual,
473     nonextensible,
474     uuid(46297823-9940-4c09-aed9-cd3ea6d05968),
475     pointer_default(unique)
476 ]
477 interface IUpdateIdentity : IDispatch
478 {
479     [propget, id(0x60020002)]
480     HRESULT RevisionNumber( [out, retval] LONG *retval );
481
482     [propget, id(0x60020003)]
483     HRESULT UpdateID( [out, retval] BSTR *retval );
484 }
485
486 [
487     ,
488     object,
489     oleautomation,
490     dual,
491     nonextensible,
492     uuid(d9a59339-e245-4dbd-9686-4d5763e39624),
493     pointer_default(unique),
494 ]
495 interface IInstallationBehavior : IDispatch
496 {
497     [propget, id(0x60020001)]
498     HRESULT CanRequestUserInput( [out, retval] VARIANT_BOOL *retval );
499
500     [propget, id(0x60020002)]
501     HRESULT Impact( [out, retval] InstallationImpact *retval );
502
503     [propget, id(0x60020003)]
504     HRESULT RebootBehavior( [out, retval] InstallationRebootBehavior *retval );
505
506     [propget, id(0x60020004)]
507     HRESULT RequiresNetworkConnectivity( [out, retval] VARIANT_BOOL *retval );
508 }
509
510 [
511     object,
512     oleautomation,
513     dual,
514     nonextensible,
515     uuid(54a2cb2d-9a0c-48b6-8a50-9abb69ee2d02),
516     pointer_default(unique),
517 ]
518 interface IUpdateDownloadContent : IDispatch
519 {
520     [propget, id(0x60020001)]
521     HRESULT DownloadUrl( [out, retval] BSTR *retval );
522 }
523
524 [
525     object,
526     oleautomation,
527     dual,
528     nonextensible,
529     uuid(bc5513c8-b3b8-4bf7-a4d4-361c0d8c88ba),
530     pointer_default(unique),
531 ]
532 interface IUpdateDownloadContentCollection : IDispatch
533 {
534     [propget, id(DISPID_VALUE)]
535     HRESULT Item( [in] LONG index,
536                   [out, retval] IUpdateDownloadContent **retval );
537
538     [propget, id(DISPID_NEWENUM)]
539     HRESULT _NewEnum( [out, retval] IUnknown **retval );
540
541     [propget, id(0x60020001)]
542     HRESULT Count( [out, retval] LONG *retval );
543 }
544
545 [
546
547     object,
548     oleautomation,
549     dual,
550     nonextensible,
551     uuid(6a92b07a-d821-4682-b423-5c805022cc4d),
552     pointer_default(unique),
553 ]
554 interface IUpdate : IDispatch
555 {
556     [propget, id(DISPID_VALUE)]
557     HRESULT Title( [out, retval] BSTR *retval );
558
559     [propget, id(0x60020001)]
560     HRESULT AutoSelectOnWebSites( [out, retval] VARIANT_BOOL *retval );
561
562     [propget, id(0x60020002)]
563     HRESULT BundledUpdates( [out, retval] IUpdateCollection **retval );
564
565     [propget, id(0x60020003)]
566     HRESULT CanRequireSource( [out, retval] VARIANT_BOOL *retval );
567
568     [propget, id(0x60020004)]
569     HRESULT Categories( [out, retval] ICategoryCollection **retval );
570
571     [propget, id(0x60020005)]
572     HRESULT Deadline( [out, retval] VARIANT *retval );
573
574     [propget, id(0x60020006)]
575     HRESULT DeltaCompressedContentAvailable( [out, retval] VARIANT_BOOL *retval );
576
577     [propget, id(0x60020007)]
578     HRESULT DeltaCompressedContentPreferred( [out, retval] VARIANT_BOOL *retval );
579
580     [propget, id(0x60020008)]
581     HRESULT Description( [out, retval] BSTR *retval );
582
583     [propget, id(0x60020009)]
584     HRESULT EulaAccepted( [out, retval] VARIANT_BOOL *retval );
585
586     [propget, id(0x6002000a)]
587     HRESULT EulaText( [out, retval] BSTR *retval );
588
589     [propget, id(0x6002000b)]
590     HRESULT HandlerID( [out, retval] BSTR *retval );
591
592     [propget, id(0x6002000c)]
593     HRESULT Identity( [out, retval] IUpdateIdentity **retval );
594
595     [propget, id(0x6002000d)]
596     HRESULT Image( [out, retval] IImageInformation **retval );
597
598     [propget, id(0x6002000e)]
599     HRESULT InstallationBehavior( [out, retval] IInstallationBehavior **retval );
600
601     [propget, id(0x6002000f)]
602     HRESULT IsBeta( [out, retval] VARIANT_BOOL *retval );
603
604     [propget, id(0x60020010)]
605     HRESULT IsDownloaded( [out, retval] VARIANT_BOOL *retval );
606
607     [propget, id(0x60020011)]
608     HRESULT IsHidden( [out, retval] VARIANT_BOOL *retval );
609
610     [propput, id(0x60020011)]
611     HRESULT IsHidden( [in] VARIANT_BOOL value );
612
613     [propget, id(0x60020012)]
614     HRESULT IsInstalled( [out, retval] VARIANT_BOOL *retval );
615
616     [propget, id(0x60020013)]
617     HRESULT IsMandatory( [out, retval] VARIANT_BOOL *retval );
618
619     [propget, id(0x60020014)]
620     HRESULT IsUninstallable( [out, retval] VARIANT_BOOL *retval );
621
622     [propget, id(0x60020015)]
623     HRESULT Languages( [out, retval] IStringCollection **retval );
624
625     [propget, id(0x60020016)]
626     HRESULT LastDeploymentChangeTime( [out, retval] DATE *retval );
627
628     [propget, id(0x60020017)]
629     HRESULT MaxDownloadSize( [out, retval] DECIMAL *retval );
630
631     [propget, id(0x60020018)]
632     HRESULT MinDownloadSize( [out, retval] DECIMAL *retval );
633
634     [propget, id(0x60020019)]
635     HRESULT MoreInfoUrls( [out, retval] IStringCollection **retval );
636
637     [propget, id(0x6002001a)]
638     HRESULT MsrcSeverity( [out, retval] BSTR *retval );
639
640     [propget, id(0x6002001b)]
641     HRESULT RecommendedCpuSpeed( [out, retval] LONG *retval );
642
643     [propget, id(0x6002001c)]
644     HRESULT RecommendedHardDiskSpace( [out, retval] LONG *retval );
645
646     [propget, id(0x6002001d)]
647     HRESULT RecommendedMemory( [out, retval] LONG *retval );
648
649     [propget, id(0x6002001e)]
650     HRESULT ReleaseNotes( [out, retval] BSTR *retval );
651
652     [propget, id(0x6002001f)]
653     HRESULT SecurityBulletinIDs( [out, retval] IStringCollection **retval );
654
655     [propget, id(0x60020021)]
656     HRESULT SupersededUpdateIDs( [out, retval] IStringCollection **retval );
657
658     [propget, id(0x60020022)]
659     HRESULT SupportUrl( [out, retval] BSTR *retval );
660
661     [propget, id(0x60020023)]
662     HRESULT Type( [out, retval] UpdateType *retval );
663
664     [propget, id(0x60020024)]
665     HRESULT UninstallationNotes( [out, retval] BSTR *retval );
666
667     [propget, id(0x60020025)]
668     HRESULT UninstallationBehavior( [out, retval] IInstallationBehavior **retval );
669
670     [propget, id(0x60020026)]
671     HRESULT UninstallationSteps( [out, retval] IStringCollection **retval );
672
673     [propget, id(0x60020028)]
674     HRESULT KBArticleIDs( [out, retval] IStringCollection **retval );
675
676     [id(0x60020027)]
677     HRESULT AcceptEula();
678
679     [propget, id(0x60020029)]
680     HRESULT DeploymentAction( [out, retval] DeploymentAction *retval );
681
682     [id(0x6002002a)]
683     HRESULT CopyFromCache( [in, ref] BSTR path,
684                            [in] VARIANT_BOOL toExtractCabFiles );
685
686     [propget, id(0x6002002b)]
687     HRESULT DownloadPriority( [out, retval] DownloadPriority *retval );
688
689     [propget, id(0x6002002c)]
690     HRESULT DownloadContents( [out, retval] IUpdateDownloadContentCollection **retval );
691 }
692
693 [
694
695     object,
696     oleautomation,
697     dual,
698     nonextensible,
699     uuid(07f7438c-7709-4ca5-b518-91279288134e),
700     pointer_default(unique),
701     hidden
702 ]
703 interface IUpdateCollection : IDispatch
704 {
705     [propget, id(DISPID_VALUE)]
706     HRESULT Item( [in] LONG index,
707                   [out, retval] IUpdate **retval );
708
709     [propput, id(DISPID_VALUE)]
710     HRESULT Item( [in] LONG index,
711                   [in] IUpdate *value );
712
713     [propget, id(DISPID_NEWENUM)]
714     HRESULT _NewEnum( [out, retval] IUnknown **retval );
715
716     [propget, id(0x60020001)]
717     HRESULT Count( [out, retval] LONG *retval );
718
719     [propget, id(0x60020002)]
720     HRESULT ReadOnly( [out, retval] VARIANT_BOOL *retval );
721
722     [id(0x60020003)]
723     HRESULT Add( [in] IUpdate *value,
724                  [out, retval] LONG *retval );
725
726     [id(0x60020004)]
727     HRESULT Clear();
728
729     [id(0x60020005)]
730     HRESULT Copy( [out, retval] IUpdateCollection **retval );
731
732     [id(0x60020006)]
733     HRESULT Insert( [in] LONG index,
734                 [in] IUpdate *value );
735
736     [id(0x60020007)]
737     HRESULT RemoveAt( [in] LONG index );
738 }
739
740 [
741     object,
742     oleautomation,
743     dual,
744     nonextensible,
745     uuid(7366ea16-7a1a-4ea2-b042-973d3e9cd99b),
746     pointer_default(unique),
747 ]
748 interface ISearchJob : IDispatch
749 {
750     [propget, id(0x60020001)]
751     HRESULT AsyncState( [out, retval] VARIANT *retval );
752
753     [propget, id(0x60020002)]
754     HRESULT IsCompleted( [out, retval] VARIANT_BOOL *retval );
755
756     [id(0x60020003)]
757     HRESULT CleanUp();
758
759     [id(0x60020004)]
760     HRESULT RequestAbort();
761 }
762
763 [
764     object,
765     oleautomation,
766     dual,
767     nonextensible,
768     uuid(d40cff62-e08c-4498-941a-01e25f0fd33c),
769     pointer_default(unique),
770 ]
771 interface ISearchResult : IDispatch
772 {
773     [propget, id(0x60020001)]
774     HRESULT ResultCode( [out, retval] OperationResultCode *retval );
775
776     [propget, id(0x60020002)]
777     HRESULT RootCategories( [out, retval] ICategoryCollection **retval );
778
779     [propget, id(0x60020003)]
780     HRESULT Updates( [out, retval] IUpdateCollection **retval );
781
782     [propget, id(0x60020004)]
783     HRESULT Warnings( [out, retval] IUpdateExceptionCollection **retval );
784 }
785
786 [
787     object,
788     oleautomation,
789     dual,
790     nonextensible,
791     uuid(be56a644-af0e-4e0e-a311-c1d8e695cbff),
792     pointer_default(unique),
793 ]
794 interface IUpdateHistoryEntry : IDispatch
795 {
796     [propget, id(0x60020001)]
797     HRESULT Operation( [out, retval] UpdateOperation *retval );
798
799     [propget, id(0x60020002)]
800     HRESULT ResultCode( [out, retval] OperationResultCode *retval );
801
802     [propget, id(0x60020003)]
803     HRESULT HResult( [out, retval] LONG *retval );
804
805     [propget, id(0x60020004)]
806     HRESULT Date( [out, retval] DATE *retval );
807
808     [propget, id(0x60020005)]
809     HRESULT UpdateIdentity( [out, retval] IUpdateIdentity **retval );
810
811     [propget, id(0x60020006)]
812     HRESULT Title( [out, retval] BSTR *retval );
813
814     [propget, id(0x60020007)]
815     HRESULT Description( [out, retval] BSTR *retval );
816
817     [propget, id(0x60020008)]
818     HRESULT UnmappedResultCode( [out, retval] LONG *retval );
819
820     [propget, id(0x60020009)]
821     HRESULT ClientApplicationID( [out, retval] BSTR *retval );
822
823     [propget, id(0x6002000a)]
824     HRESULT ServerSelection( [out, retval] ServerSelection *retval );
825
826     [propget, id(0x6002000b)]
827     HRESULT ServiceID( [out, retval] BSTR *retval );
828
829     [propget, id(0x6002000c)]
830     HRESULT UninstallationSteps( [out, retval] IStringCollection **retval );
831
832     [propget, id(0x6002000d)]
833     HRESULT UninstallationNotes( [out, retval] BSTR *retval );
834
835     [propget, id(0x6002000e)]
836     HRESULT SupportUrl( [out, retval] BSTR *retval );
837 }
838
839 [
840     object,
841     oleautomation,
842     dual,
843     nonextensible,
844     uuid(a7f04f3c-a290-435b-aadf-a116c3357a5c),
845     pointer_default(unique),
846 ]
847 interface IUpdateHistoryEntryCollection : IDispatch
848 {
849     [propget, id(DISPID_VALUE)]
850     HRESULT Item( [in] LONG index,
851                   [out, retval] IUpdateHistoryEntry **retval );
852
853     [propget, id(DISPID_NEWENUM)]
854     HRESULT _NewEnum( [out, retval] IUnknown **retval );
855
856     [propget, id(0x60020001)]
857     HRESULT Count( [out, retval] LONG *retval );
858 }
859
860 [
861     object,
862     uuid(8f45abf1-f9ae-4b95-a933-f0f66e5056ea),
863     oleautomation,
864     dual,
865     nonextensible,
866     pointer_default(unique),
867 ]
868 interface IUpdateSearcher : IDispatch
869 {
870     [propget]
871     HRESULT CanAutomaticallyUpgradeService(
872         [out, retval] VARIANT_BOOL *retval);
873
874     [propput]
875     HRESULT CanAutomaticallyUpgradeService(
876         [in] VARIANT_BOOL value);
877
878     [propget]
879     HRESULT ClientApplicationID(
880         [out, retval] BSTR *retval);
881
882     [propput]
883     HRESULT ClientApplicationID(
884         [in] BSTR value);
885
886     [propget]
887     HRESULT IncludePotentiallySupersededUpdates(
888         [out, retval] VARIANT_BOOL *retval);
889
890     [propput]
891     HRESULT IncludePotentiallySupersededUpdates(
892         [in] VARIANT_BOOL value);
893
894     [propget]
895     HRESULT ServerSelection(
896         [out, retval] ServerSelection *retval);
897
898     [propput]
899     HRESULT ServerSelection(
900         [in] ServerSelection value);
901
902     HRESULT BeginSearch(
903         [in] BSTR criteria,
904         [in] IUnknown *onCompleted,
905         [in] VARIANT state,
906         [out, retval] ISearchJob **retval);
907
908     HRESULT EndSearch(
909         [in] ISearchJob *searchJob,
910         [out, retval] ISearchResult **retval);
911
912     HRESULT EscapeString(
913         [in] BSTR unescaped,
914         [out, retval] BSTR *retval);
915
916     HRESULT QueryHistory(
917         [in] LONG startIndex,
918         [in] LONG count,
919         [out, retval] IUpdateHistoryEntryCollection **retval);
920
921     HRESULT Search(
922         [in] BSTR criteria,
923         [out, retval] ISearchResult **retval);
924
925     [propget]
926     HRESULT Online(
927         [out, retval] VARIANT_BOOL *retval);
928
929     [propput]
930     HRESULT Online(
931         [in] VARIANT_BOOL value);
932
933     HRESULT GetTotalHistoryCount(
934         [out, retval] LONG *retval);
935
936     [propget]
937     HRESULT ServiceID(
938         [out, retval] BSTR *retval);
939
940     [propput]
941     HRESULT ServiceID(
942         [in] BSTR value);
943 }
944
945 [
946     object,
947     oleautomation,
948     dual,
949     nonextensible,
950     uuid(bf99af76-b575-42ad-8aa4-33cbb5477af1),
951     pointer_default(unique),
952 ]
953 interface IUpdateDownloadResult : IDispatch
954 {
955     [propget, id(0x60020001)]
956     HRESULT HResult( [out, retval] LONG *retval );
957
958     [propget, id(0x60020002)]
959     HRESULT ResultCode( [out, retval] OperationResultCode *retval );
960 }
961
962 [
963     object,
964     oleautomation,
965     dual,
966     nonextensible,
967     uuid(d31a5bac-f719-4178-9dbb-5e2cb47fd18a),
968     pointer_default(unique),
969 ]
970 interface IDownloadProgress : IDispatch
971 {
972     [propget, id(0x60020001)]
973     HRESULT CurrentUpdateBytesDownloaded( [out, retval] DECIMAL *retval );
974
975     [propget, id(0x60020002)]
976     HRESULT CurrentUpdateBytesToDownload( [out, retval] DECIMAL *retval );
977
978     [propget, id(0x60020003)]
979     HRESULT CurrentUpdateIndex( [out, retval] LONG *retval );
980
981     [propget, id(0x60020004)]
982     HRESULT PercentComplete( [out, retval] LONG *retval );
983
984     [propget, id(0x60020005)]
985     HRESULT TotalBytesDownloaded( [out, retval] DECIMAL *retval );
986
987     [propget, id(0x60020006)]
988     HRESULT TotalBytesToDownload( [out, retval] DECIMAL *retval );
989
990     [id(0x60020007)]
991     HRESULT GetUpdateResult( [in] LONG updateIndex,
992                              [out, retval] IUpdateDownloadResult **retval );
993
994
995     [propget, id(0x60020008)]
996     HRESULT CurrentUpdateDownloadPhase( [out, retval] DownloadPhase *retval );
997
998     [propget, id(0x60020009)]
999     HRESULT CurrentUpdatePercentComplete( [out, retval] LONG *retval );
1000 }
1001
1002 [
1003     object,
1004     oleautomation,
1005     dual,
1006     nonextensible,
1007     uuid(c574de85-7358-43f6-aae8-8697e62d8ba7),
1008     pointer_default(unique),
1009 ]
1010 interface IDownloadJob : IDispatch
1011 {
1012     [propget, id(0x60020001)]
1013     HRESULT AsyncState( [out, retval] VARIANT *retval );
1014
1015     [propget, id(0x60020002)]
1016     HRESULT IsCompleted( [out, retval] VARIANT_BOOL *retval );
1017
1018     [propget, id(0x60020003)]
1019     HRESULT Updates( [out, retval] IUpdateCollection **retval );
1020
1021     [id(0x60020004)]
1022     HRESULT CleanUp();
1023
1024     [id(0x60020005)]
1025     HRESULT GetProgress( [out, retval] IDownloadProgress **retval );
1026
1027     [id(0x60020006)]
1028     HRESULT RequestAbort();
1029 }
1030
1031 [
1032     object,
1033     oleautomation,
1034     dual,
1035     nonextensible,
1036     uuid(daa4fdd0-4727-4dbe-a1e7-745dca317144),
1037     pointer_default(unique),
1038 ]
1039 interface IDownloadResult : IDispatch
1040 {
1041     [propget, id(0x60020001)]
1042     HRESULT HResult( [out, retval] LONG *retval );
1043
1044     [propget, id(0x60020002)]
1045     HRESULT ResultCode( [out, retval] OperationResultCode *retval );
1046
1047     [id(0x60020003)]
1048     HRESULT GetUpdateResult( [in] LONG updateIndex,
1049                              [out, retval] IUpdateDownloadResult **retval );
1050 }
1051
1052 [
1053     object,
1054     uuid(68f1c6f9-7ecc-4666-a464-247fe12496c3),
1055     oleautomation,
1056     dual,
1057     nonextensible,
1058     pointer_default(unique),
1059     hidden
1060 ]
1061 interface IUpdateDownloader : IDispatch
1062 {
1063     [propget]
1064     HRESULT ClientApplicationID(
1065         [out, retval] BSTR *retval);
1066
1067     [propput]
1068     HRESULT ClientApplicationID(
1069         [in] BSTR value);
1070
1071     [propget]
1072     HRESULT IsForced(
1073         [out, retval] VARIANT_BOOL *retval);
1074
1075     [propput]
1076     HRESULT IsForced(
1077         [in] VARIANT_BOOL value);
1078
1079     [propget]
1080     HRESULT Priority(
1081         [out, retval] DownloadPriority *retval);
1082
1083     [propput]
1084     HRESULT Priority(
1085         [in] DownloadPriority value);
1086
1087     [propget]
1088     HRESULT Updates(
1089         [out, retval] IUpdateCollection **retval);
1090
1091     [propput]
1092     HRESULT Updates(
1093         [in] IUpdateCollection *value);
1094
1095     HRESULT BeginDownload(
1096         [in] IUnknown *onProgressChanged,
1097         [in] IUnknown *onCompleted,
1098         [in] VARIANT state,
1099         [out, retval] IDownloadJob **retval);
1100
1101     HRESULT Download(
1102         [out, retval] IDownloadResult **retval);
1103
1104     HRESULT EndDownload(
1105         [in] IDownloadJob *value,
1106         [out, retval] IDownloadResult **retval);
1107 }
1108
1109 [
1110     object,
1111     oleautomation,
1112     dual,
1113     nonextensible,
1114     uuid(d940f0f8-3cbb-4fd0-993f-471e7f2328ad),
1115     pointer_default(unique),
1116 ]
1117 interface IUpdateInstallationResult : IDispatch
1118 {
1119     [propget, id(0x60020001)]
1120     HRESULT HResult( [out, retval] LONG *retval );
1121
1122     [propget, id(0x60020002)]
1123     HRESULT RebootRequired( [out, retval] VARIANT_BOOL *retval );
1124
1125     [propget, id(0x60020003)]
1126     HRESULT ResultCode( [out, retval] OperationResultCode *retval );
1127 }
1128
1129 [
1130     object,
1131     oleautomation,
1132     dual,
1133     nonextensible,
1134     uuid(345c8244-43a3-4e32-a368-65f073b76f36),
1135     pointer_default(unique),
1136 ]
1137 interface IInstallationProgress : IDispatch
1138 {
1139     [propget, id(0x60020001)]
1140     HRESULT CurrentUpdateIndex( [out, retval] LONG *retval );
1141
1142     [propget, id(0x60020002)]
1143     HRESULT CurrentUpdatePercentComplete( [out, retval] LONG *retval );
1144
1145     [propget, id(0x60020003)]
1146     HRESULT PercentComplete( [out, retval] LONG *retval );
1147
1148     [id(0x60020004)]
1149     HRESULT GetUpdateResult( [in] LONG updateIndex,
1150                              [out, retval] IUpdateInstallationResult **retval );
1151 }
1152
1153 [
1154     object,
1155     oleautomation,
1156     dual,
1157     nonextensible,
1158     uuid(5c209f0b-bad5-432a-9556-4699bed2638a),
1159     pointer_default(unique),
1160 ]
1161 interface IInstallationJob : IDispatch
1162 {
1163     [propget, id(0x60020001)]
1164     HRESULT AsyncState( [out, retval] VARIANT *retval );
1165
1166     [propget, id(0x60020002)]
1167     HRESULT IsCompleted( [out, retval] VARIANT_BOOL *retval );
1168
1169     [propget, id(0x60020003)]
1170     HRESULT Updates( [out, retval] IUpdateCollection **retval );
1171
1172     [id(0x60020004)]
1173     HRESULT CleanUp();
1174
1175     [id(0x60020005)]
1176     HRESULT GetProgress( [out, retval] IInstallationProgress **retval );
1177
1178     [id(0x60020006)]
1179     HRESULT RequestAbort();
1180 }
1181
1182 [
1183     object,
1184     oleautomation,
1185     dual,
1186     nonextensible,
1187     uuid(a43c56d6-7451-48d4-af96-b6cd2d0d9b7a),
1188     pointer_default(unique),
1189 ]
1190 interface IInstallationResult : IDispatch
1191 {
1192     [propget, id(0x60020001)]
1193     HRESULT HResult( [out, retval] LONG *retval );
1194
1195     [propget, id(0x60020002)]
1196     HRESULT RebootRequired( [out, retval] VARIANT_BOOL *retval );
1197
1198     [propget, id(0x60020003)]
1199     HRESULT ResultCode( [out, retval] OperationResultCode *retval );
1200
1201     [id(0x60020004)]
1202     HRESULT GetUpdateResult( [in] LONG updateIndex,
1203                              [out, retval] IUpdateInstallationResult **retval );
1204 }
1205
1206 [
1207     object,
1208     uuid(7b929c68-ccdc-4226-96b1-8724600b54c2),
1209     oleautomation,
1210     dual,
1211     nonextensible,
1212     pointer_default(unique),
1213 ]
1214 interface IUpdateInstaller : IDispatch
1215 {
1216     [propget]
1217     HRESULT ClientApplicationID(
1218         [out, retval] BSTR *retval);
1219
1220     [propput]
1221     HRESULT ClientApplicationID(
1222         [in] BSTR value);
1223
1224     [propget]
1225     HRESULT IsForced(
1226         [out, retval] VARIANT_BOOL *retval);
1227
1228     [propput]
1229     HRESULT IsForced(
1230         [in] VARIANT_BOOL value);
1231
1232     [propget, restricted]
1233     HRESULT ParentHwnd(
1234         [out, retval] HWND *retval);
1235
1236     [propput, restricted]
1237     HRESULT ParentHwnd(
1238         [in, unique] HWND value);
1239
1240     [propput]
1241     HRESULT ParentWindow(
1242         [in, unique] IUnknown *value);
1243
1244     [propget]
1245     HRESULT ParentWindow(
1246         [out, retval] IUnknown **retval);
1247
1248     [propget]
1249     HRESULT Updates(
1250         [out, retval] IUpdateCollection **retval);
1251
1252     [propput]
1253     HRESULT Updates(
1254         [in] IUpdateCollection *value);
1255
1256     HRESULT BeginInstall(
1257         [in] IUnknown *onProgressChanged,
1258         [in] IUnknown *onCompleted,
1259         [in] VARIANT state,
1260         [out, retval] IInstallationJob **retval);
1261
1262     HRESULT BeginUninstall(
1263         [in] IUnknown *onProgressChanged,
1264         [in] IUnknown *onCompleted,
1265         [in] VARIANT state,
1266         [out, retval] IInstallationJob **retval);
1267
1268     HRESULT EndInstall(
1269         [in] IInstallationJob *value,
1270         [out, retval] IInstallationResult **retval);
1271
1272     HRESULT EndUninstall(
1273         [in] IInstallationJob *value,
1274         [out, retval] IInstallationResult **retval);
1275
1276     HRESULT Install(
1277         [out, retval] IInstallationResult **retval);
1278
1279     HRESULT RunWizard(
1280         [in, defaultvalue("")] BSTR dialogTitle,
1281         [out, retval] IInstallationResult **retval);
1282
1283     [propget]
1284     HRESULT IsBusy(
1285         [out, retval] VARIANT_BOOL *retval);
1286
1287     HRESULT Uninstall(
1288         [out, retval] IInstallationResult **retval);
1289
1290     [propget]
1291     HRESULT AllowSourcePrompts(
1292         [out, retval] VARIANT_BOOL *retval);
1293
1294     [propput]
1295     HRESULT AllowSourcePrompts(
1296         [in] VARIANT_BOOL value);
1297
1298     [propget]
1299     HRESULT RebootRequiredBeforeInstallation(
1300         [out, retval] VARIANT_BOOL *retval);
1301 }
1302
1303 [
1304     helpstring("AutomaticUpdates Class"),
1305     threading(both),
1306     progid("Microsoft.Update.AutoUpdate.1"),
1307     vi_progid("Microsoft.Update.AutoUpdate"),
1308     uuid(bfe18e9c-6d87-4450-b37c-e02f0b373803)
1309 ]
1310 coclass AutomaticUpdates { interface IAutomaticUpdates; }
1311
1312 [
1313     helpstring("UpdateSession Class"),
1314     threading(both),
1315     progid("Microsoft.Update.Session.1"),
1316     vi_progid("Microsoft.Update.Session"),
1317     uuid(4cb43d7f-7eee-4906-8698-60da1c38f2fe)
1318 ]
1319 coclass UpdateSession { interface IUpdateSession; }
1320
1321 } /* WUApiLib */