IUpdateSearcher interface

Searches for updates on a server.

Members

The IUpdateSearcher interface inherits from the IDispatch interface. IUpdateSearcher also has these types of members:

  • Methods
  • Properties

Methods

The IUpdateSearcher interface has these methods.

Method Description
BeginSearch

Begins execution of an asynchronous search for updates. The search uses the search options that are currently configured.

EndSearch

Completes an asynchronous search for updates.

EscapeString

Converts a string into a string that can be used as a literal value in a search criteria string.

GetTotalHistoryCount

Returns the number of update events on the computer.

QueryHistory

Synchronously queries the computer for the history of update events.

Search

Performs a synchronous search for updates. The search uses the search options that are currently configured.

 

Properties

The IUpdateSearcher interface has these properties.

Property Access type Description

CanAutomaticallyUpgradeService

Read/write

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).

ClientApplicationID

Read/write

Identifies the current client application.

IncludePotentiallySupersededUpdates

Read/write

Gets and sets a Boolean value that indicates whether the search results include updates that are superseded by other updates in the search results.

Online

Read/write

Gets and sets a Boolean value that indicates whether the UpdateSearcher goes online to search for updates.

ServerSelection

Read/write

Gets and sets a ServerSelection value that indicates the server to search for updates.

ServiceID

Read/write

Gets and sets a site to search when the site to search is not a Windows Update site.

 

Remarks

You can create an instance of this interface by using the UpdateSearcher coclass. Use the Microsoft.Update.Searcher program identifier to create the object.

Requirements

Minimum supported client

Windows XP, Windows 2000 Professional with SP3 [desktop apps only]

Minimum supported server

Windows Server 2003, Windows 2000 Server with SP3 [desktop apps only]

Header

Wuapi.h

IDL

Wuapi.idl

Library

Wuguid.lib

DLL

Wuapi.dll

IID

IID_IUpdateSearcher is defined as 8F45ABF1-F9AE-4B95-A933-F0F66E5056EA