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