Update the google_update_idl to reflect recent changes to Omaha.

google_update/google_update_idl.idl

 // Copyright 2009-2010 Google Inc.
 //
 // Licensed under the Apache License, Version 2.0 (the "License");
 // you may not use this file except in compliance with the License.
 // You may obtain a copy of the License at
 //
 //      http://www.apache.org/licenses/LICENSE-2.0
 //
 // Unless required by applicable law or agreed to in writing, software
 // distributed under the License is distributed on an "AS IS" BASIS,
@@ skipping 77 matching lines @@
   POST_INSTALL_ACTION_RESTART_BROWSER = 4,
 
   // Similar to POST_INSTALL_ACTION_RESTART_BROWSER, but ask the user to shut
   // down all browsers.
   POST_INSTALL_ACTION_RESTART_ALL_BROWSERS = 5,
 
   // The caller should ask the user to reboot the machine.
   POST_INSTALL_ACTION_REBOOT = 6,
 } PostInstallAction;
 
+enum AppCommandStatus {
+  // The command has never been executed.
+  COMMAND_STATUS_INIT = 1,
+  // The command is running.
+  COMMAND_STATUS_RUNNING = 2,
+  // An error occurred while launching or monitoring the command.
+  COMMAND_STATUS_ERROR = 3,
+  // The command has completed execution.
+  COMMAND_STATUS_COMPLETE = 4,
+};
+
 [
   object,
   dual,
   uuid(6DB17455-4E85-46e7-9D23-E555E4B005AF),
   helpstring("IGoogleUpdate3 Interface"),
   pointer_default(unique)
 ]
 interface IGoogleUpdate3 : IDispatch {
   // TODO(Omaha): Perhaps this interface exposes helpers such as
   // RestartBrowsers, etc.
 
   // Returns the count of the AppBundles in this IGoogleUpdate3 interface.
   [id(1), propget] HRESULT Count([out, retval] long* count);
 
   // Returns an IDispatch of the AppBundle in this IGoogleUpdate3 interface at
   // the specified 0-based index. This property has the dispid of DISPID_VALUE
   // to make it the default property of IGoogleUpdate3.
   [id(DISPID_VALUE), propget] HRESULT Item([in] long index,
                                            [out, retval] IDispatch** bundle);
   // Returns an IDispatch to a newly created empty AppBundle.
   [id(2)] HRESULT createAppBundle([out, retval] IDispatch** app_bundle);
 }
 
 [
   object,
   dual,
-  uuid(313cfb25-4888-4fc6-9e19-764d8c5fc8f8),
+  uuid(fe908cdd-22bb-472a-9870-1a0390e42f36),
   helpstring("IAppBundle Interface"),
   pointer_default(unique)
 ]
 interface IAppBundle : IDispatch {
   // TODO(omaha3): AppBundle::display_name_ is never used. Should we remove?
   [propget] HRESULT displayName([out, retval] BSTR*);
   [propput] HRESULT displayName([in] BSTR);
 
   [propget] HRESULT displayLanguage([out, retval] BSTR*);
   [propput] HRESULT displayLanguage([in] BSTR);
 
   [propget] HRESULT installSource([out, retval] BSTR*);
   [propput] HRESULT installSource([in] BSTR);
 
   [propget] HRESULT originURL([out, retval] BSTR*);
   [propput] HRESULT originURL([in] BSTR);
 
   [propget] HRESULT offlineDirectory([out, retval] BSTR* offline_dir);
   [propput] HRESULT offlineDirectory([in] BSTR offline_dir);
 
   [propget] HRESULT sessionId([out, retval] BSTR* session_id);
   [propput] HRESULT sessionId([in] BSTR session_id);
 
+  // Controls whether or not event pings should be sent at the end of
+  // an operation.
+  [propget] HRESULT sendPings([out, retval] VARIANT_BOOL* send_pings);
+  [propput] HRESULT sendPings([in] VARIANT_BOOL send_pings);
+
   // The priority property determines download speed/priority and the number/
   // frequency of retries.  Use values from the InstallPriority enum.
   [propget] HRESULT priority([out, retval] long* priority);
   [propput] HRESULT priority([in] long priority);
 
   // Returns the count of the Apps in the AppBundle.
   [id(1), propget] HRESULT Count([out, retval] long* count);
 
   // Returns an IDispatch of the App in the AppBundle at the specified 0-based
   // index. This property has the dispid of DISPID_VALUE to make it the default
@@ skipping 62 matching lines @@
   // available from App in all post-update check states.
   // To do this, we will probably need to know the total expected download
   // size for all packages to be installed - those that are required or in use -
   // by the time the update check phase is complete.
   [id(15), propget] HRESULT currentState([out, retval] VARIANT* current_state);
 };
 
 [
   object,
   dual,
-  uuid(D999CE21-98B3-4894-BACB-A49A1D50848F),
+  uuid(76F7B787-A67C-4c73-82C7-31F5E3AABC5C),
   helpstring("IApp Interface"),
   pointer_default(unique)
 ]
 interface IApp : IDispatch {
   // Returns a version IDispatch object.
   [id(1), propget] HRESULT currentVersion([out, retval] IDispatch** current);
   [id(2), propget] HRESULT nextVersion([out, retval] IDispatch** next);
 
   [propget] HRESULT appId([out, retval] BSTR*);
 
@@ skipping 17 matching lines @@
 
   [propget] HRESULT clientId([out, retval] BSTR*);
   [propput] HRESULT clientId([in] BSTR);
 
   [propget] HRESULT labels([out, retval] BSTR*);
   [propput] HRESULT labels([in] BSTR);
 
   [propget] HRESULT referralId([out, retval] BSTR*);
   [propput] HRESULT referralId([in] BSTR);
 
+  // Returns an IDispatch to a command defined by this installed app with the
+  // specified ID, or NULL if this app is not installed or the command ID is not
+  // recognized.
+  [propget] HRESULT command([in] BSTR command_id,
+                            [out, retval] IDispatch** command);
+
   // Use values from the BrowserType enum.
   [propget] HRESULT browserType([out, retval] UINT*);
   [propput] HRESULT browserType([in] UINT);
 
   [propget] HRESULT clientInstallData([out, retval] BSTR*);
   [propput] HRESULT clientInstallData([in] BSTR);
 
   [propget] HRESULT serverInstallDataIndex([out, retval] BSTR*);
   [propput] HRESULT serverInstallDataIndex([in] BSTR);
 
   // Set as soon as possible. Error pings are disabled until set to true.
   [propget] HRESULT isEulaAccepted([out, retval] VARIANT_BOOL*);
   [propput] HRESULT isEulaAccepted([in] VARIANT_BOOL);
 
   [propget] HRESULT usageStatsEnable([out, retval] UINT*);
   [propput] HRESULT usageStatsEnable([in] UINT);
 
   [propget] HRESULT installTimeDiffSec([out, retval] UINT*);
 
   // Returns an ICurrentState interface. The object underlying the interface has
   // static data that does not get updated as the server state changes. To get
   // the most "current" state, the currentState property needs to be queried
   // again.
   [propget] HRESULT currentState([out, retval] IDispatch**);
 };
 
 [
   object,
   dual,
+  uuid(4DE778FE-F195-4ee3-9DAB-FE446C239221),
+  helpstring("IAppCommand Interface"),
+  pointer_default(unique)
+]
+interface IAppCommand : IDispatch {
+  [propget] HRESULT isWebAccessible([out, retval] VARIANT_BOOL*);
+  // Use values from the AppCommandStatus enum.
+  [propget] HRESULT status([out, retval] UINT*);
+  [propget] HRESULT exitCode([out, retval] DWORD*);
+  HRESULT execute([in, optional] VARIANT arg1,
+                  [in, optional] VARIANT arg2,
+                  [in, optional] VARIANT arg3,
+                  [in, optional] VARIANT arg4,
+                  [in, optional] VARIANT arg5,
+                  [in, optional] VARIANT arg6,
+                  [in, optional] VARIANT arg7,
+                  [in, optional] VARIANT arg8,
+                  [in, optional] VARIANT arg9);
+};
+
+[
+  object,
+  dual,
   uuid(BCDCB538-01C0-46d1-A6A7-52F4D021C272),
   helpstring("IAppVersion Interface"),
   pointer_default(unique)
 ]
 interface IAppVersion : IDispatch {
   [propget] HRESULT version([out, retval] BSTR*);
 
   // [propget] HRESULT installManifest([out, retval] BSTR*);
 
   // Returns the count of the Packages in the AppVersion.
@@ skipping 207 matching lines @@
   HRESULT cancel();
 
   HRESULT downloadPackage([in] BSTR app_id, [in] BSTR package_name);
 
   [propget] HRESULT currentState([out, retval] VARIANT* current_state);
 };
 
 [
   object,
   dual,
-  uuid(C6398F88-69CE-44ac-B6A7-1D3E2AA46679),
+  uuid(18D0F672-18B4-48e6-AD36-6E6BF01DBBC4),
   helpstring("IAppWeb Interface"),
   pointer_default(unique),
 ]
 interface IAppWeb : IDispatch {
   [propget] HRESULT appId([out, retval] BSTR*);
 
   // Returns an IAppVersionWeb IDispatch object.
   [propget] HRESULT currentVersionWeb([out, retval] IDispatch** current);
   [propget] HRESULT nextVersionWeb([out, retval] IDispatch** next);
 
+  // Returns an IAppCommandWeb IDispatch object, or NULL.
+  [propget] HRESULT command([in] BSTR command_id,
+                            [out, retval] IDispatch** command);
+
   HRESULT cancel();
   [propget] HRESULT currentState([out, retval] IDispatch** current_state);
   HRESULT launch();
   HRESULT uninstall();
 };
 
 [
   object,
   dual,
+  uuid(68D6C2BD-712E-4c96-93E8-49CB8A9AAEED),
+  helpstring("IAppCommandWeb Interface"),
+  pointer_default(unique)
+]
+interface IAppCommandWeb : IDispatch {
+  // Use values from the AppCommandStatus enum.
+  [propget] HRESULT status([out, retval] UINT*);
+  [propget] HRESULT exitCode([out, retval] DWORD*);
+  HRESULT execute([in, optional] VARIANT arg1,
+                  [in, optional] VARIANT arg2,
+                  [in, optional] VARIANT arg3,
+                  [in, optional] VARIANT arg4,
+                  [in, optional] VARIANT arg5,
+                  [in, optional] VARIANT arg6,
+                  [in, optional] VARIANT arg7,
+                  [in, optional] VARIANT arg8,
+                  [in, optional] VARIANT arg9);
+};
+
+[
+  object,
+  dual,
   uuid(0CD01D1E-4A1C-489d-93B9-9B6672877C57),
   helpstring("IAppVersionWeb Interface"),
   pointer_default(unique)
 ]
 interface IAppVersionWeb : IDispatch {
   [propget] HRESULT version([out, retval] BSTR*);
 
   // Returns the count of the Packages in the AppVersion.
   [propget] HRESULT packageCount([out, retval] long* count);
 
@@ skipping 156 matching lines @@
 interface IJobObserver : IUnknown {
   HRESULT OnShow();
   HRESULT OnCheckingForUpdate();
   HRESULT OnUpdateAvailable([in, string] const WCHAR* version_string);
   HRESULT OnWaitingToDownload();
   HRESULT OnDownloading([in] int time_remaining_ms, [in] int pos);
   HRESULT OnWaitingToInstall();
   HRESULT OnInstalling();
   HRESULT OnPause();
   HRESULT OnComplete([in] LegacyCompletionCodes code,
-                     [in, string] const WCHAR* reserved);
+                     [in, string] const WCHAR* completion_text);
   HRESULT SetEventSink([in] IProgressWndEvents* ui_sink);
 };
 
 [
   object,
   oleautomation,
   uuid(31AC3F11-E5EA-4a85-8A3D-8E095A39C27B),
   helpstring("IGoogleUpdate Interface"),
   pointer_default(unique)
 ]
@@ skipping 40 matching lines @@
 ]
 library GoogleUpdate3Lib {
   importlib("stdole2.tlb");
 
   // These Interfaces are forward declared to ensure that they are described in
   // the generated TLB file. This is required for ATL to correctly implement the
   // corresponding IDispatch interfaces.
   interface IGoogleUpdate3;
   interface IAppBundle;
   interface IApp;
+  interface IAppCommand;
   interface IAppVersion;
   interface IPackage;
   interface ICurrentState;
 
   interface IGoogleUpdate3Web;
   interface IAppBundleWeb;
   interface IAppWeb;
+  interface IAppCommandWeb;
   interface IAppVersionWeb;
   interface ICoCreateAsyncStatus;
 
   [
     uuid(022105BD-948A-40c9-AB42-A3300DDF097F),
     helpstring("GoogleUpdate3 Class for per-user applications")
   ]
   coclass GoogleUpdate3UserClass {
     [default] interface IDispatch;
   }
@@ skipping 149 matching lines @@
     uuid(9B2340A0-4068-43d6-B404-32E27217859D),
     helpstring("GoogleUpdateCore Machine Class")
   ]
   coclass GoogleUpdateCoreMachineClass
   {
     [default] interface IUnknown;
   }
 
   // END Legacy google_update_idl coclasses.
 };