IUpdateSearcher::BeginSearch method (wuapi.h)
Begins execution of an asynchronous search for updates. The search uses the search options that are currently configured.
HRESULT BeginSearch( [in] BSTR criteria, [in] IUnknown *onCompleted, [in] VARIANT state, [out] ISearchJob **retval );
A string that specifies the search criteria.
An ISearchCompletedCallback interface that is called when an asynchronous search operation is complete.
An ISearchJob interface that represents the current operation that might be pending.
The caller passes the returned value to the EndSearch method to complete a search operation.
Returns S_OK if successful. Otherwise, returns a COM or Windows error code.
This method can also return the following error codes.
||A parameter value is invalid or NULL.|
||This method cannot be called from a remote computer.|
For a complete description of search criteria syntax, see Search.
As an alternative to implementing the ISearchCompletedCallback interface, you can use a script to implement a callback routine of any identifier with DISPID 0 on an automation object. The type of the onCompleted parameter is IUnknown*.
When you use any asynchronous WUA API in your app, you might need to implement a time-out mechanism. For more info about how to perform asynchronous WUA operations, see Guidelines for Asynchronous WUA Operations.
|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]|