Windows Update Agent API
Overview of the Windows Update Agent API technology.
To develop Windows Update Agent API, you need these headers:
- wuapi.h
- wuapicommon.h
For programming guidance for this technology, see:
- Windows Update Agent API
- Windows Update Agent (WUA) API Reference
- Using the Windows Update Agent API
Enumerations
| AddServiceFlag Defines the possible ways in which the IUpdateServiceManager2 interface can process service registration requests. |
| AutoDownloadMode Defines the types of logic that is used to determine whether Automatic Updates will automatically download an update once it is determined to be applicable for the computer. |
| AutomaticUpdatesNotificationLevel Defines the possible ways in which elevated users are notified about Automatic Updates events. |
| AutomaticUpdatesPermissionType Defines the possible ways to set the NotificationLevel property of the IAutomaticUpdatesSettings interface or the IncludeRecommendedUpdates property of the IAutomaticUpdatesSettings2 interface. |
| AutomaticUpdatesScheduledInstallationDay Defines the days of the week when Automatic Updates installs or uninstalls updates. |
| AutomaticUpdatesUserType Defines the type of user. |
| AutoSelectionMode Defines the types of logic that is used to determine whether a particular update will be automatically selected when the user views available updates in the Windows Update user interface. |
| DeploymentAction Defines the action for which an update is explicitly deployed. |
| DownloadPhase Defines the progress of the download of the current update that is returned by the CurrentUpdateDownloadPhase property of the IDownloadProgress interface. |
| DownloadPriority Defines the possible priorities for a download operation. |
| InstallationImpact Defines the possible levels of impact that can be caused by installing or uninstalling an update. |
| InstallationRebootBehavior Defines the possible restart behaviors for an update. |
| OperationResultCode Defines the possible results of a download, install, uninstall, or verification operation on an update. |
| SearchScope Defines the variety of updates that should be returned by the search:_per-machine updates, per-user updates, or both. |
| UpdateExceptionContext Defines the context in which an IUpdateException object can be provided. |
| UpdateLockdownOption Defines the functionality that the Windows Update Agent (WUA) object can access from Windows Update. |
| UpdateOperation Defines operations that can be attempted on an update. |
| UpdateServiceOption Defines the options that affect how the service registration for a scan package service is removed. |
| UpdateServiceRegistrationState Defines the possible states for an update service. |
| UpdateType Defines the types of update, such as a driver or software update. |
Functions
| AcceptEula Accepts the Microsoft Software License Terms that are associated with Windows Update. |
| Add Adds an item to the collection. (IStringCollection.Add) |
| Add Adds an item to the collection. (IUpdateCollection.Add) |
| AddScanPackageService Registers a scan package as a service with Windows Update Agent (WUA) and then returns an IUpdateService interface. |
| AddService Registers a service with Windows Update Agent (WUA). |
| AddService2 Registers a service with Windows Update Agent (WUA) without requiring an authorization cabinet file (.cab). This method also returns a pointer to an IUpdateServiceRegistration interface. |
| BeginDownload Starts an asynchronous download of the content files that are associated with the updates. |
| BeginInstall Starts an asynchronous installation of the updates. |
| BeginSearch Begins execution of an asynchronous search for updates. The search uses the search options that are currently configured. |
| BeginUninstall Starts an asynchronous uninstallation of the updates. |
| CheckPermission Determines whether a specific user or type of user has permission to perform a selected action. |
| CleanUp Waits for an asynchronous operation to be completed and releases all callbacks. |
| CleanUp Waits for an asynchronous operation to be completed and then releases all the callbacks. |
| CleanUp Waits for an asynchronous operation to complete and then releases all the callbacks. |
| Clear Removes all the elements from the collection. (IStringCollection.Clear) |
| Clear Removes all the elements from the collection. (IUpdateCollection.Clear) |
| Commit Finalizes updates that were previously staged or installed. |
| Copy Creates a deep read/write copy of the collection. |
| Copy Creates a shallow read/write copy of the collection. |
| CopyFromCache Copies the contents of an update to a specified path. |
| CopyToCache Copies files for an update from a specified source location to the internal Windows Update Agent (WUA) download cache. |
| CopyToCache Copies the external update binaries to an update. |
| CreateUpdateDownloader Returns an IUpdateDownloader interface for this session. |
| CreateUpdateInstaller Returns an IUpdateInstaller interface for this session. |
| CreateUpdateSearcher Returns an IUpdateSearcher interface for this session. |
| CreateUpdateServiceManager Returns a pointer to an IUpdateServiceManager2 interface for the session. |
| DetectNow Begins the Automatic Updates detection task if Automatic Updates is enabled. If any updates are detected, the installation behavior is determined by the NotificationLevel property of the IAutomaticUpdatesSettings interface. |
| Download Starts a synchronous download of the content files that are associated with the updates. |
| EnableService Enables all the components that Automatic Updates requires. |
| EndDownload Completes an asynchronous download. |
| EndInstall Completes an asynchronous installation of the updates. |
| EndSearch Completes an asynchronous search for updates. |
| EndUninstall Completes an asynchronous uninstallation of the updates. |
| EscapeString Converts a string into a string that can be used as a literal value in a search criteria string. |
| get__NewEnum Gets an IEnumVARIANT interface that can be used to enumerate the collection. (ICategoryCollection.get__NewEnum) |
| get__NewEnum Gets an IEnumVARIANT interface that can be used to enumerate the collection. (IStringCollection.get__NewEnum) |
| get__NewEnum Gets an IEnumVARIANT interface that can be used to enumerate the collection. (IUpdateCollection.get__NewEnum) |
| get__NewEnum Gets an IEnumVARIANT interface that is used to enumerate the collection. (IUpdateDownloadContentCollection.get__NewEnum) |
| get__NewEnum Gets an IEnumVARIANT interface that can be used to enumerate the collection. (IUpdateExceptionCollection.get__NewEnum) |
| get__NewEnum Gets an IEnumVARIANT interface that can be used to enumerate the collection. (IUpdateHistoryEntryCollection.get__NewEnum) |
| get__NewEnum Gets an IEnumVARIANT interface that can be used to enumerate the collection. (IUpdateServiceCollection.get__NewEnum) |
| get__NewEnum Gets an IEnumVARIANT interface that is used to enumerate the collection. (IWindowsDriverUpdateEntryCollection.get__NewEnum) |
| get_Address Gets and sets the address and the decimal port number of the proxy server. (Get) |
| get_AllowSourcePrompts Gets and sets a Boolean value that indicates whether to show source prompts to the user when installing the updates. (Get) |
| get_AltText Gets the alternate text for the image. |
| get_AsyncState Gets the caller-specific state object that is passed to the IUpdateDownloader.BeginDownload method. |
| get_AsyncState Gets the caller-specific state object that is passed to the IUpdateInstaller.BeginInstall method or to the IUpdateInstaller.BeginUninstall method. |
| get_AsyncState Gets the caller-specific state object that is passed to the IUpdateSearch.BeginSearch method. |
| get_AttemptCloseAppsIfNecessary Gets a value indicating whether the update installer will attempt to close applications, blocking immediate installation of updates. |
| get_AutoDetect Gets and sets a Boolean value that indicates whether IWebProxy automatically detects proxy settings. (Get) |
| get_AutoDownload Gets a value indicating the automatic download mode of update. |
| get_AutoDownload Gets an AutoDownloadMode value that indicates the automatic download mode of update. |
| get_AutoSelection Gets a value indicating the automatic selection mode of update in the Control Panel of Windows Update. |
| get_AutoSelection Gets an AutoSelectionMode value indicating the automatic selection mode of an update in the Control Panel of Windows Update. |
| get_AutoSelectOnWebSites Gets a Boolean value that indicates whether the update is flagged to be automatically selected by Windows Update. |
| get_BrowseOnly Gets a Boolean value that indicates whether an update can be discovered only by browsing through the available updates. (IUpdate3.get_BrowseOnly) |
| get_BrowseOnly Gets a Boolean value that indicates whether an update can be discovered only by browsing through the available updates. (IWindowsDriverUpdate3.get_BrowseOnly) |
| get_BundledUpdates Gets an interface that contains information about the ordered list of the bundled updates for the update. |
| get_BypassList Gets and sets a collection of addresses that do not use the proxy server. (Get) |
| get_BypassProxyOnLocal Gets and sets a Boolean value that indicates whether local addresses bypass the proxy server. (Get) |
| get_CanAutomaticallyUpgradeService Gets and sets a Boolean value that indicates whether future calls to the BeginSearch and Search methods result in an automatic upgrade to Windows Update Agent (WUA). (Get) |
| get_CanRegisterWithAU Gets a Boolean value that indicates whether the service can register with Automatic Updates. |
| get_CanRequestUserInput Gets a Boolean value thast indicates whether the installation or uninstallation of an update can prompt for user input. |
| get_CanRequireSource Gets a Boolean value that indicates whether the source media of the update is required for installation or uninstallation. |
| get_Categories Gets an interface that contains a collection of categories to which the update belongs. |
| get_Categories Gets a collection of the update categories to which an update belongs. |
| get_CategoryID Gets the identifier of the category. |
| get_Children Gets an interface collection that contains the child categories of this category. |
| get_ClientApplicationID Gets and sets the current client application. (IUpdateDownloader.get_ClientApplicationID) |
| get_ClientApplicationID Gets the identifier of the client application that processed an update. |
| get_ClientApplicationID Gets and sets the current client application. (IUpdateInstaller.get_ClientApplicationID) |
| get_ClientApplicationID Identifies the current client application. (Get) |
| get_ClientApplicationID Gets and sets the identifier of the current client application. (Get) |
| get_ClientApplicationID Gets and sets the current client application. (IUpdateSession.get_ClientApplicationID) |
| get_ContentValidationCert Gets an SHA-1 hash of the certificate that is used to sign the contents of the service. |
| get_Context Gets the context of search results. |
| get_Count Gets the number of elements in the collection. (ICategoryCollection.get_Count) |
| get_Count Gets the number of elements in the collection. (IStringCollection.get_Count) |
| get_Count Gets the number of elements in the collection. (IUpdateCollection.get_Count) |
| get_Count Gets the number of elements in the collection. (IUpdateDownloadContentCollection.get_Count) |
| get_Count Gets the number of elements in the collection. (IUpdateExceptionCollection.get_Count) |
| get_Count Gets the number of elements in the collection. (IUpdateHistoryEntryCollection.get_Count) |
| get_Count Gets the number of elements in the collection. (IUpdateServiceCollection.get_Count) |
| get_Count Gets the number of elements contained in the collection. |
| get_CurrentUpdateBytesDownloaded Gets a string that specifies how much data has been transferred for the content file or files of the update that is being downloaded, in bytes. |
| get_CurrentUpdateBytesToDownload Gets a string that estimates how much data should be transferred for the content file or files of the update that is being downloaded, in bytes. |
| get_CurrentUpdateDownloadPhase Gets a DownloadPhase enumeration value that specifies the phase of the download that is currently in progress. |
| get_CurrentUpdatePercentComplete Gets an estimate of the percentage of the current update that has been downloaded. |
| get_CurrentUpdatePercentComplete Gets how far the installation or uninstallation process for the current update has progressed, as a percentage. |
| get_CveIDs Gets a collection of common vulnerabilities and exposures (CVE) IDs that are associated with the update. |
| get_CveIDs Contains a collection of the Common Vulnerabilities and Exposures (CVE) identifiers that are associated with an update. |
| get_Date Gets the date and the time an update was applied. |
| get_Deadline Gets the date by which the update must be installed. |
| get_DeltaCompressedContentAvailable Gets a Boolean value that indicates whether delta-compressed content is available on a server for the update. |
| get_DeltaCompressedContentPreferred Gets a Boolean value that indicates whether to prefer delta-compressed content during the download and install or uninstall of the update if delta-compressed content is available. |
| get_DeploymentAction Gets the action for which the update is deployed. |
| get_Description Gets the description of the category. |
| get_Description Gets the localized description of the update. |
| get_Description Gets the description of an update. |
| get_DeviceProblemNumber Gets the problem number of the matching device for the Windows driver update. (IWindowsDriverUpdate.get_DeviceProblemNumber) |
| get_DeviceProblemNumber Gets the problem number of the matching device for the Windows driver update. (IWindowsDriverUpdateEntry.get_DeviceProblemNumber) |
| get_DeviceStatus Gets the status of the matching device for the Windows driver update. (IWindowsDriverUpdate.get_DeviceStatus) |
| get_DeviceStatus Gets the status of the matching device for the Windows driver update. (IWindowsDriverUpdateEntry.get_DeviceStatus) |
| get_DownloadContents Gets file information about the download contents of the update. |
| get_DownloadPriority Gets the suggested download priority of the update. |
| get_DownloadUrl Gets the location of the download content on the server that hosts the update. |
| get_DriverClass Gets the class of the Windows driver update. |
| get_DriverClass Retrieves the class of the Windows driver update. |
| get_DriverHardwareID Gets the hardware ID or compatible ID that the Windows driver update must match to be installable. |
| get_DriverHardwareID Gets the hardware or the compatible identifier that the Windows driver update must match to be installable. |
| get_DriverManufacturer Gets the language-invariant name of the manufacturer of the Windows driver update. (IWindowsDriverUpdate.get_DriverManufacturer) |
| get_DriverManufacturer Gets the language-invariant name of the manufacturer of the Windows driver update. (IWindowsDriverUpdateEntry.get_DriverManufacturer) |
| get_DriverModel Gets the language-invariant model name of the device for which the Windows driver update is intended. (IWindowsDriverUpdate.get_DriverModel) |
| get_DriverModel Gets the language-invariant model name of the device for which the Windows driver update is intended. (IWindowsDriverUpdateEntry.get_DriverModel) |
| get_DriverProvider Gets the language-invariant name of the provider of the Windows driver update. (IWindowsDriverUpdate.get_DriverProvider) |
| get_DriverProvider Gets the language-invariant name of the provider of the Windows driver update. (IWindowsDriverUpdateEntry.get_DriverProvider) |
| get_DriverVerDate Gets the driver version date of the Windows driver update. (IWindowsDriverUpdate.get_DriverVerDate) |
| get_DriverVerDate Gets the driver version date of the Windows driver update. (IWindowsDriverUpdateEntry.get_DriverVerDate) |
| get_EulaAccepted Gets a Boolean value that indicates whether the Microsoft Software License Terms that are associated with the update are accepted for the computer. |
| get_EulaText Gets the full localized text of the Microsoft Software License Terms that are associated with the update. |
| get_ExpirationDate Gets the date on which the authorization cabinet file expires. |
| get_FeaturedUpdatesEnabled Not supported. (IAutomaticUpdatesSettings3.get_FeaturedUpdatesEnabled) |
| get_ForceQuiet Gets and sets a Boolean value that indicates whether Windows Installer is forced to install the updates without user interaction. (Get) |
| get_HandlerID Gets the install handler of the update. |
| get_Height Gets the height of the image, in pixels. |
| get_HResult Gets the exception code number if an exception code number is raised during the download. |
| get_HResult Gets the HRESULT of the exception, if any, that is raised during the installation. |
| get_HResult Gets the exception HRESULT value, if any, that is raised during the operation on the update. |
| get_HResult Gets the Windows-based HRESULT code for the search results. |
| get_HResult Gets the HRESULT value that is returned from the operation on an update. |
| get_HResult Gets the HRESULT exception value that is raised during the operation on an update. |
| get_Identity Gets an interface that contains the unique identifier of the update. |
| get_IgnoreDownloadPriority Gets and sets a Boolean value that indicates whether to ignore the download priority. (Get) |
| get_Image Gets an interface that contains information about the image that is associated with the category. |
| get_Image Gets an interface that contains information about an image that is associated with the update. |
| get_Impact Gets an InstallationImpact enumeration that indicates how the installation or uninstallation of the update affects the computer. |
| get_IncludePotentiallySupersededUpdates Gets and sets a Boolean value that indicates whether the search results include updates that are superseded by other updates in the search results. (Get) |
| get_IncludeRecommendedUpdates Gets and sets a Boolean value that indicates whether to include optional or recommended updates when a search for updates and installation of updates is performed. (Get) |
| get_InstallationBehavior Gets an interface that contains the installation options of the update. |
| get_IsBeta Gets a Boolean value that indicates whether the update is a beta release. |
| get_IsBusy Gets a Boolean value that indicates whether an installation or uninstallation is in progress on a computer at a specific time. |
| get_IsCompleted Gets the setting that indicates whether the call to IUpdateDownloader.BeginDownload was processed completely. |
| get_IsCompleted Gets a value that indicates whether a call to the IUpdateInstaller.BeginInstall or IUpdateInstaller.BeginUninstall method is completely processed. |
| get_IsCompleted Gets a Boolean value that indicates whether the call to the IUpdateSearch.BeginSearch method is completely processed. |
| get_IsDefaultAUService Gets a Boolean value that indicates whether the service is registered with Automatic Updates and whether the service is currently used by Automatic Updates as the default service. |
| get_IsDeltaCompressedContent Gets a Boolean value that indicates whether an update is a binary update or a full-file update. |
| get_IsDownloaded Gets a Boolean value that indicates whether all the update content is cached on the computer. |
| get_IsForced Gets and sets a Boolean value that indicates whether the Windows Update Agent (WUA) forces the download of updates that are already installed or that cannot be installed. (Get) |
| get_IsForced Gets or sets a Boolean value that indicates whether to forcibly install or uninstall an update. (Get) |
| get_IsHidden Gets a Boolean value that indicates whether an update is hidden by a user. (Get) |
| get_IsInstalled Gets a Boolean value that indicates whether the update is installed on a computer when the search is performed. |
| get_IsManaged Gets a Boolean value that indicates whether a service is a managed service. |
| get_IsMandatory Gets a Boolean value that indicates whether the installation of the update is mandatory. |
| get_IsPendingRegistrationWithAU Gets a Boolean value that indicates whether the service will also be registered with Automatic Updates, when added. |
| get_IsPresent Gets a Boolean value that indicates whether an update is present on a computer. |
| get_IsPresent Gets a Boolean value that indicates whether an update is installed on a computer. |
| get_IsRegisteredWithAU Gets a Boolean value that indicates whether a service is registered with Automatic Updates. |
| get_IsScanPackageService Gets a Boolean value that indicates whether a service is based on a scan package. |
| get_IssueDate Gets the date on which the authorization cabinet file was issued. |
| get_IsUninstallable Gets a Boolean value that indicates whether a user can uninstall the update from a computer. |
| get_Item Gets an ICategory interface from the collection. |
| get_Item Gets or sets a string in the collection. (Get) |
| get_Item Gets or sets an IUpdate interface in a collection. (Get) |
| get_Item Gets the download content for an update from an IUpdateDownloadContentCollection interface. |
| get_Item Gets an IUpdateException interface in the collection. |
| get_Item Gets an IUpdateHistoryEntry interface in the collection. |
| get_Item Gets and sets an IUpdateService interface in a collection. |
| get_Item Gets an IWindowsDriverUpdateEntry interface in the collection. |
| get_KBArticleIDs Gets a collection of Microsoft Knowledge Base article IDs that are associated with the update. |
| get_Languages Gets an interface that contains the languages that are supported by the update. |
| get_LastDeploymentChangeTime Gets the last published date of the update, in Coordinated Universal Time (UTC) date and time, on the server that deploys the update. |
| get_LastInstallationSuccessDate Gets the last time and Coordinated Universal Time (UTC) date when Automatic Updates successfully installed any updates, even if some failures occurred. |
| get_LastSearchSuccessDate Gets the last time and Coordinated Universal Time (UTC) date when AutomaticUpdates successfully searched for updates. |
| get_MaxDownloadSize Gets the maximum download size of the update. |
| get_Message Gets a message that describes the search results. |
| get_MinDownloadSize Gets the minimum download size of the update. |
| get_MoreInfoUrls Gets a collection of language-specific strings that specify the hyperlinks to more information about the update. |
| get_MsrcSeverity Gets the Microsoft Security Response Center severity rating of the update. |
| get_Name Gets the localized name of the category. |
| get_Name Gets the name of the service. |
| get_NonAdministratorsElevated Gets and sets a Boolean value that indicates whether non-administrators can perform some update-related actions without administrator approval. (Get) |
| get_NotificationLevel Gets and sets how users are notified about Automatic Update events. (Get) |
| get_OemHardwareSupportLink Gets a hyperlink to technical support information for OEM hardware. |
| get_OffersWindowsUpdates Gets a Boolean value indicates whether the current service offers updates from Windows Updates. |
| get_Online Gets and sets a Boolean value that indicates whether the UpdateSearcher goes online to search for updates. (Get) |
| get_Operation Gets an UpdateOperation value that specifies the operation on an update. |
| get_Order Gets the recommended display order of this category among its sibling categories. |
| get_Parent Gets an interface that describes the parent category of this category. |
| get_ParentHwnd Gets and sets a handle to the parent window that can contain a dialog box. (Get) |
| get_ParentWindow Gets and sets the interface that represents the parent window that can contain a dialog box. (Get) |
| get_PercentComplete Gets an estimate of the percentage of all the updates that have been downloaded. |
| get_PercentComplete Gets how far the overall installation or uninstallation process has progressed, as a percentage. |
| get_PerUser Gets a Boolean value that indicates whether this is a per-user update. |
| get_PerUser Gets a Boolean value that indicates whether an update is a per-user update. |
| get_Priority Gets and sets the priority level of the download. (Get) |
| get_Product Gets the language-invariant name of the product. |
| get_Progress Gets an interface that contains the progress of the asynchronous download at the time that the callback was made. |
| get_Progress Gets an interface that contains the progress of the asynchronous installation or uninstallation at the time the callback was made. |
| get_ReadOnly Gets a Boolean value that indicates whether the Automatic Update settings are read-only. |
| get_ReadOnly Gets a Boolean value that indicates whether the collection is read-only. |
| get_ReadOnly Gets a Boolean value that indicates whether the update collection is read-only. |
| get_ReadOnly Gets a Boolean value that indicates whether the session object is read-only. |
| get_ReadOnly Gets a Boolean value that indicates whether the WebProxy object is read-only. |
| get_RebootBehavior Gets an InstallationRebootBehavior enumeration that specifies the restart behavior that occurs when you install or uninstall the update. |
| get_RebootRequired Gets a Boolean value that indicates whether you must restart the computer to complete the installation or uninstallation of an update. |
| get_RebootRequired Gets a Boolean value that indicates whether a system restart is required to complete the installation or uninstallation of one or more updates. |
| get_RebootRequired Gets a Boolean value that indicates whether a system restart is required on a computer to complete the installation or the uninstallation of an update. |
| get_RebootRequired Gets a Boolean value that indicates whether a system restart is required on a computer to complete the installation of an update. |
| get_RebootRequired Gets a Boolean value that indicates whether the computer must be restarted after you install or uninstall an update. |
| get_RebootRequiredBeforeInstallation Gets a Boolean value that indicates whether a system restart is required before installing or uninstalling updates. |
| get_RecommendedCpuSpeed Gets the recommended CPU speed used to install the update, in megahertz (MHz). |
| get_RecommendedHardDiskSpace Gets the recommended free space that should be available on the hard disk before you install the update. The free space is specified in megabytes (MB). |
| get_RecommendedMemory Gets the recommended physical memory size that should be available in your computer before you install the update. The physical memory size is specified in megabytes (MB). |
| get_RedirectUrls Contains the URLs for the redirector cabinet file. |
| get_RegistrationState Gets an UpdateServiceRegistrationState value that indicates the current state of the service registration. |
| get_ReleaseNotes Gets the localized release notes for the update. |
| get_Required Gets a Boolean value that indicates whether Group Policy requires the Automatic Updates service. |
| get_RequiresNetworkConnectivity Gets a Boolean value that indicates whether the installation or uninstallation of an update requires network connectivity. |
| get_ResultCode Gets an OperationResultCodeenumeration that specifies the result of the download. |
| get_ResultCode Gets an OperationResultCode value that specifies the result of an operation on an update. (IInstallationResult.get_ResultCode) |
| get_ResultCode Gets an OperationResultCode enumeration that specifies the result of a search. |
| get_ResultCode Gets an OperationResultCode enumeration value that specifies the result of an operation on the update. |
| get_ResultCode Gets an OperationResultCode value that specifies the result of an operation on an update. (IUpdateHistoryEntry.get_ResultCode) |
| get_ResultCode Gets an OperationResultCode value that specifies the result of an operation on an update. (IUpdateInstallationResult.get_ResultCode) |
| get_Results Returns a pointer to an IAutomaticUpdatesResults interface. |
| get_RevisionNumber Gets the revision number of an update. |
| get_RootCategories Gets an interface collection of the root categories that are currently available on the computer. |
| get_ScheduledInstallationDay Gets and sets the days of the week on which Automatic Updates installs or uninstalls updates. (Get) |
| get_ScheduledInstallationTime Gets and sets the time at which Automatic Updates installs or uninstalls updates. (Get) |
| get_SecurityBulletinIDs Gets a collection of string values that contain the security bulletin IDs that are associated with the update. |
| get_ServerSelection Gets the ServerSelection value that indicates which server provided an update. |
| get_ServerSelection Gets and sets a ServerSelection value that indicates the server to search for updates. (Get) |
| get_Service Gets a pointer to an IUpdateService2 interface. This property is the default property. |
| get_ServiceEnabled Gets a Boolean value that indicates whether all the components that Automatic Updates requires are available. |
| get_ServiceID Gets the service identifier of an update service that is not a Windows update. |
| get_ServiceID Gets and sets a site to search when the site to search is not a Windows Update site. (Get) |
| get_ServiceID Retrieves or sets the identifier for a service. |
| get_Services Gets an IUpdateServiceCollection of the services that are registered with WUA. |
| get_ServiceUrl Retrieves the URL for the service. |
| get_Settings Gets the configuration settings for Automatic Updates. |
| get_SetupPrefix Identifies the prefix for the setup files. |
| get_Source Gets the source location of the image. |
| get_SupersededUpdateIDs Gets a collection of update identifiers. This collection of identifiers specifies the updates that are superseded by the update. |
| get_SupportUrl Gets a hyperlink to the language-specific support information for the update. |
| get_SupportUrl Gets a hyperlink to the language-specific support information for an update. |
| get_Title Gets the localized title of the update. |
| get_Title Gets the title of an update. |
| get_TotalBytesDownloaded Gets a string that specifies the total amount of data that has been downloaded, in bytes. |
| get_TotalBytesToDownload Gets a string that represents the estimate of the total amount of data that will be downloaded, in bytes. |
| get_Type Gets the type of the category. |
| get_Type Gets the type of the update. |
| get_UninstallationBehavior Gets an interface that contains the uninstallation options for the update. |
| get_UninstallationNotes Gets the uninstallation notes for the update. |
| get_UninstallationNotes Gets the uninstallation notes of an update. |
| get_UninstallationSteps Gets an interface that contains the uninstallation steps for the update. |
| get_UninstallationSteps Gets the IStringCollection interface that contains the uninstallation steps for an update. |
| get_UnmappedResultCode Gets the unmapped result code that is returned from an operation on an update. |
| get_UpdateID Gets the revision-independent identifier of an update. |
| get_UpdateIdentity Gets the IUpdateIdentity interface that contains the identity of the update. |
| get_Updates Gets an interface that contains a collection of updates that immediately belong to the category. |
| get_Updates Gets an interface that contains a read-only collection of the updates that are specified in a download. |
| get_Updates Gets an interface that contains a read-only collection of the updates that are specified in the installation or uninstallation. |
| get_Updates Gets an interface collection of the updates that result from a search. |
| get_Updates Gets and sets an interface that contains a read-only collection of the updates that are specified for download. (Get) |
| get_Updates Gets and sets an interface that contains a read-only collection of the updates that are specified for installation or uninstallation. (Get) |
| get_UserLocale Gets and sets the preferred locale for which update information is retrieved.. (Get) |
| get_UserName Gets and sets the user name to submit to the proxy server for authentication. (Get) |
| get_Warnings Gets a collection of the warnings that result from a search. |
| get_WebProxy Gets and sets the proxy settings that are used to access the server. (Get) |
| get_Width Gets the width of the image, in pixels. |
| get_WindowsDriverUpdateEntries Gets the driver update entries that are applicable for the update. |
| GetInfo Retrieves version information about Windows Update Agent (WUA). |
| GetProgress Returns an IDownloadProgress interface that describes the current progress of a download. |
| GetProgress Returns an IInstallationProgress interface that describes the current progress of an installation or uninstallation. |
| GetTotalHistoryCount Returns the number of update events on the computer. |
| GetUpdateResult Returns the result of the download of a specified update. |
| GetUpdateResult Returns an IUpdateDownloadResult interface that contains the download information for a specified update. |
| GetUpdateResult Returns the result of the installation or uninstallation of a specified update. |
| GetUpdateResult Returns an IUpdateInstallationResult interface that contains the installation results for a specified update. |
| Insert Inserts an item into the collection at the specified position. (IStringCollection.Insert) |
| Insert Inserts an item into the collection at the specified position. (IUpdateCollection.Insert) |
| Install Starts a synchronous installation of the updates. |
| Invoke Notifies the caller that the download is complete. |
| Invoke Handles the notification of a change in the progress of an asynchronous download that was initiated by calling the IUpdateDownloader.BeginDownload method. |
| Invoke Handles the notification of the completion of an asynchronous installation or uninstallation that is initiated by a call to IUpdateInstaller.BeginInstall or IUpdateInstaller.BeginUninstall. |
| Invoke Handles the notification of the change in the progress of an asynchronous installation or uninstallation that was initiated by a call to the IUpdateInstaller.BeginInstall method or the IUpdateInstaller.BeginUninstall method. |
| Invoke Handles the notification of the completion of an asynchronous search that is initiated by calling the IUpdateSearcher.BeginSearch method. |
| LockDown Restricts access to the methods and properties of the object that implements this method. |
| Pause Pauses automatic updates. |
| PromptForCredentials Prompts the user for the password to use for proxy authentication. |
| PromptForCredentialsFromHwnd Prompts the user for a password to use for proxy authentication using the hWnd property of the parent window. |
| put_Address Gets and sets the address and the decimal port number of the proxy server. (Put) |
| put_AllowSourcePrompts Gets and sets a Boolean value that indicates whether to show source prompts to the user when installing the updates. (Put) |
| put_AttemptCloseAppsIfNecessary Sets a value indicating whether the update installer will attempt to close applications, blocking immediate installation of updates. |
| put_AutoDetect Gets and sets a Boolean value that indicates whether IWebProxy automatically detects proxy settings. (Put) |
| put_BypassList Gets and sets a collection of addresses that do not use the proxy server. (Put) |
| put_BypassProxyOnLocal Gets and sets a Boolean value that indicates whether local addresses bypass the proxy server. (Put) |
| put_CanAutomaticallyUpgradeService Gets and sets a Boolean value that indicates whether future calls to the BeginSearch and Search methods result in an automatic upgrade to Windows Update Agent (WUA). (Put) |
| put_ClientApplicationID Gets and sets the current client application. (IUpdateDownloader.put_ClientApplicationID) |
| put_ClientApplicationID Gets and sets the current client application. (IUpdateInstaller.put_ClientApplicationID) |
| put_ClientApplicationID Identifies the current client application. (Put) |
| put_ClientApplicationID Gets and sets the identifier of the current client application. (Put) |
| put_ClientApplicationID Gets and sets the current client application. (IUpdateSession.put_ClientApplicationID) |
| put_FeaturedUpdatesEnabled Not supported. (IAutomaticUpdatesSettings3.put_FeaturedUpdatesEnabled) |
| put_ForceQuiet Gets and sets a Boolean value that indicates whether Windows Installer is forced to install the updates without user interaction. (Put) |
| put_IgnoreDownloadPriority Gets and sets a Boolean value that indicates whether to ignore the download priority. (Put) |
| put_IncludePotentiallySupersededUpdates Gets and sets a Boolean value that indicates whether the search results include updates that are superseded by other updates in the search results. (Put) |
| put_IncludeRecommendedUpdates Gets and sets a Boolean value that indicates whether to include optional or recommended updates when a search for updates and installation of updates is performed. (Put) |
| put_IsForced Gets and sets a Boolean value that indicates whether the Windows Update Agent (WUA) forces the download of updates that are already installed or that cannot be installed. (Put) |
| put_IsForced Gets or sets a Boolean value that indicates whether to forcibly install or uninstall an update. (Put) |
| put_IsHidden Gets a Boolean value that indicates whether an update is hidden by a user. (Put) |
| put_Item Gets or sets a string in the collection. (Put) |
| put_Item Gets or sets an IUpdate interface in a collection. (Put) |
| put_NonAdministratorsElevated Gets and sets a Boolean value that indicates whether non-administrators can perform some update-related actions without administrator approval. (Put) |
| put_NotificationLevel Gets and sets how users are notified about Automatic Update events. (Put) |
| put_Online Gets and sets a Boolean value that indicates whether the UpdateSearcher goes online to search for updates. (Put) |
| put_ParentHwnd Gets and sets a handle to the parent window that can contain a dialog box. (Put) |
| put_ParentWindow Gets and sets the interface that represents the parent window that can contain a dialog box. (Put) |
| put_Priority Gets and sets the priority level of the download. (Put) |
| put_ScheduledInstallationDay Gets and sets the days of the week on which Automatic Updates installs or uninstalls updates. (Put) |
| put_ScheduledInstallationTime Gets and sets the time at which Automatic Updates installs or uninstalls updates. (Put) |
| put_ServerSelection Gets and sets a ServerSelection value that indicates the server to search for updates. (Put) |
| put_ServiceID Gets and sets a site to search when the site to search is not a Windows Update site. (Put) |
| put_Updates Gets and sets an interface that contains a read-only collection of the updates that are specified for download. (Put) |
| put_Updates Gets and sets an interface that contains a read-only collection of the updates that are specified for installation or uninstallation. (Put) |
| put_UserLocale Gets and sets the preferred locale for which update information is retrieved.. (Put) |
| put_UserName Gets and sets the user name to submit to the proxy server for authentication. (Put) |
| put_WebProxy Gets and sets the proxy settings that are used to access the server. (Put) |
| QueryHistory Synchronously queries the computer for the history of the update events. |
| QueryHistory Synchronously queries the computer for the history of update events. |
| QueryServiceRegistration Returns a pointer to an IUpdateServiceRegistration interface. |
| RecordInstallationResult Records the result for an update. The result is specified by an IStringCollection object. |
| Refresh Retrieves the latest Automatic Updates settings. |
| RegisterServiceWithAU Registers a service with Automatic Updates. |
| RemoveAt Removes the item at the specified index from the collection. (IStringCollection.RemoveAt) |
| RemoveAt Removes the item at the specified index from the collection. (IUpdateCollection.RemoveAt) |
| RemoveService Removes a service registration from Windows Update Agent (WUA). |
| RequestAbort Makes a request to end an asynchronous download. |
| RequestAbort Makes a request to cancel the installation or uninstallation. |
| RequestAbort Makes a request to cancel the asynchronous search. |
| Resume Restarts automatic updating if automatic updating is paused. |
| RunWizard Starts a wizard that guides the local user through the steps to install the updates. |
| Save Applies the current Automatic Updates settings. |
| Search Performs a synchronous search for updates. The search uses the search options that are currently configured. |
| SetOption Set options for the object that specifies the service ID. The SetOption method is also used to determine whether a warning is displayed when you change the registration of Automatic Updates. |
| SetPassword Sets the password to submit to the proxy server for authentication. |
| ShowSettingsDialog Displays a dialog box that contains settings for Automatic Updates. |
| Uninstall Starts a synchronous uninstallation of the updates. |
| UnregisterServiceWithAU Unregisters a service with Automatic Updates. |
Interfaces
| IAutomaticUpdates Contains the functionality of Automatic Updates. (IAutomaticUpdates) |
| IAutomaticUpdates2 Contains the functionality of Automatic Updates. (IAutomaticUpdates2) |
| IAutomaticUpdatesResults Contains the read-only properties that describe Automatic Updates. |
| IAutomaticUpdatesSettings Contains the settings that are available in Automatic Updates. (IAutomaticUpdatesSettings) |
| IAutomaticUpdatesSettings2 Contains the settings that are available in Automatic Updates. (IAutomaticUpdatesSettings2) |
| IAutomaticUpdatesSettings3 Contains the settings that are available in Automatic Updates. (IAutomaticUpdatesSettings3) |
| ICategory Represents the category to which an update belongs. |
| ICategoryCollection Represents an ordered read-only list of ICategory interfaces. |
| IDownloadCompletedCallback Provides the callback that is used when an asynchronous download is completed. |
| IDownloadCompletedCallbackArgs Contains information about the completion of a download. This interface acts as a parameter to the IDownloadCompletedCallback delegate. The download and installation of the update is asynchronous. |
| IDownloadJob Contains properties and methods that are available to a download operation. |
| IDownloadProgress Represents the progress of an asynchronous download operation. |
| IDownloadProgressChangedCallback Handles the notification that indicates a change in the progress of an asynchronous download operation. |
| IDownloadProgressChangedCallbackArgs Contains information about the change in the progress of an asynchronous download operation. |
| IDownloadResult Represents the result of a download operation. |
| IImageInformation Contains information about a localized image that is associated with an update or a category. |
| IInstallationAgent Records the result for an update. |
| IInstallationBehavior Represents the installation and uninstallation options of an update. |
| IInstallationCompletedCallback Handles the notification that indicates that an asynchronous installation or uninstallation is complete. |
| IInstallationCompletedCallbackArgs Contains information about the completion of an installation and acts as a parameter to the IInstallationCompletedCallback delegate. The download and installation of the update is asynchronous. |
| IInstallationJob Contains properties and methods that are available to an installation or uninstallation operation. |
| IInstallationProgress Represents the progress of an asynchronous installation or uninstallation. |
| IInstallationProgressChangedCallback Defines the Invoke method that handles the notification about the on-going progress of an asynchronous installation or uninstallation. |
| IInstallationProgressChangedCallbackArgs Contains information about the change in the progress of an asynchronous installation or uninstallation at the time the callback was made. |
| IInstallationResult Represents the result of an installation or uninstallation. |
| IInvalidProductLicenseException Encapsulates the exception that is thrown when an invalid license is detected for a product. |
| ISearchCompletedCallback Contains a method that handles the notification about the completion of an asynchronous search operation. |
| ISearchCompletedCallbackArgs Contains information about the completion of an asynchronous search. It also acts as a parameter to the SearchCompletedCallback delegate. |
| ISearchJob Contains properties and methods that are available to a search operation. |
| ISearchResult Represents the result of a search. |
| IStringCollection Represents an ordered list of strings. |
| ISystemInformation Contains information about the specified computer. This information is relevant to the Windows Update Agent (WUA). |
| IUpdate Contains the properties and methods that are available to an update. (IUpdate) |
| IUpdate2 Contains the properties and methods that are available to an update. (IUpdate2) |
| IUpdate3 Contains the properties and methods that are available to an update. (IUpdate3) |
| IUpdate4 Contains the properties and methods that are available to an update. (IUpdate4) |
| IUpdate5 Contains the properties and methods that are available to an update. (IUpdate5) |
| IUpdateCollection Represents an ordered list of updates. |
| IUpdateDownloadContent Represents the download content of an update. (IUpdateDownloadContent) |
| IUpdateDownloadContent2 Represents the download content of an update. (IUpdateDownloadContent2) |
| IUpdateDownloadContentCollection Represents a collection of download contents for an update. |
| IUpdateDownloader Downloads updates from the server. |
| IUpdateDownloadResult Contains the properties that indicate the status of a download operation for an update. |
| IUpdateException Represents info about the aspects of search results returned in the ISearchResult object that were incomplete. |
| IUpdateExceptionCollection Represents an ordered read-only list of IUpdateException interfaces. |
| IUpdateHistoryEntry Represents the recorded history of an update. (IUpdateHistoryEntry) |
| IUpdateHistoryEntry2 Represents the recorded history of an update. (IUpdateHistoryEntry2) |
| IUpdateHistoryEntryCollection Represents an ordered read-only list of IUpdateHistoryEntry interfaces. |
| IUpdateIdentity Represents the unique identifier of an update. |
| IUpdateInstallationResult Contains the properties and the methods that are available to the status of an installation or uninstallation of an update. |
| IUpdateInstaller Installs or uninstalls updates from or onto a computer. |
| IUpdateInstaller2 Installs or uninstalls updates on a computer. (IUpdateInstaller2) |
| IUpdateInstaller3 Installs or uninstalls updates on a computer. (IUpdateInstaller3) |
| IUpdateInstaller4 Provides methods to finalize updates that were previously staged or installed. |
| IUpdateLockdown Restricts access to methods and properties of objects that implements the method of this interface. |
| IUpdateSearcher Searches for updates on a server. (IUpdateSearcher) |
| IUpdateSearcher2 Searches for updates on a server. (IUpdateSearcher2) |
| IUpdateSearcher3 Searches for updates on a server. (IUpdateSearcher3) |
| IUpdateService Contains information about a service that is registered with Windows Update Agent (WUA) or with Automatic Updates. (IUpdateService) |
| IUpdateService2 Contains information about a service that is registered with Windows Update Agent (WUA) or with Automatic Updates. (IUpdateService2) |
| IUpdateServiceCollection Represents a list of IUpdateService interfaces. |
| IUpdateServiceManager Adds or removes the registration of the update service with Windows Update Agent or Automatic Updates. (IUpdateServiceManager) |
| IUpdateServiceManager2 Adds or removes the registration of the update service with Windows Update Agent or Automatic Updates. (IUpdateServiceManager2) |
| IUpdateServiceRegistration Contains information about the registration state of a service. |
| IUpdateSession Represents a session in which the caller can perform operations that involve updates. For example, this interface represents sessions in which the caller performs a search, download, installation, or uninstallation operation. (IUpdateSession) |
| IUpdateSession2 Represents a session in which the caller can perform operations that involve updates. For example, this interface represents sessions in which the caller performs a search, download, installation, or uninstallation operation. (IUpdateSession2) |
| IUpdateSession3 Represents a session in which the caller can perform operations that involve updates. For example, this interface represents sessions in which the caller performs a search, download, installation, or uninstallation operation. (IUpdateSession3) |
| IWebProxy Contains the HTTP proxy settings. |
| IWindowsDriverUpdate Contains the properties and the methods that are available only from a Windows driver update. |
| IWindowsDriverUpdate2 Contains the properties and methods that are available only from a Windows driver update. (IWindowsDriverUpdate2) |
| IWindowsDriverUpdate3 Contains the properties and methods that are available only from a Windows driver update. (IWindowsDriverUpdate3) |
| IWindowsDriverUpdate4 Contains the properties and methods that are available only from a Windows driver update. (IWindowsDriverUpdate4) |
| IWindowsDriverUpdate5 Contains the properties and methods that are available only from a Windows driver update. (IWindowsDriverUpdate5) |
| IWindowsDriverUpdateEntry Contains the properties that are available only from a Windows driver update. |
| IWindowsDriverUpdateEntryCollection Contains a collection of driver update entries associated with a driver update. All of the properties have the standard collection semantics. |
| IWindowsUpdateAgentInfo Retrieves information about the version of Windows Update Agent (WUA). |
Feedback
Coming soon: Throughout 2024 we will be phasing out GitHub Issues as the feedback mechanism for content and replacing it with a new feedback system. For more information see: https://aka.ms/ContentUserFeedback.
Submit and view feedback for