IUpdateSearcher::EndSearch method

Completes an asynchronous search for updates.

Syntax


HRESULT EndSearch(
  [in]   ISearchJob *searchJob,
  [out]  ISearchResult **retval
);

Parameters

searchJob [in]

The ISearchJob interface that the BeginSearch method returns.

retval [out]

An ISearchResult interface that contains the following:

  • The result of an operation
  • A collection of updates that match the search criteria

Return value

Returns S_OK if successful. Otherwise, returns a COM or Windows error code.

This method can also return the following error codes.

Return codeDescription
S_OK

An asynchronous search for updates is successful.

WU_E_LEGACYSERVER

You cannot search for updates if the ServerSelection property of IUpdateSearcher is set to ssManagedServer or to ssDefault, and the managed server on a computer is a Microsoft Software Update Services (SUS) 1.0 server.

E_POINTER

A parameter value is invalid or NULL.

E_ACCESSDENIED

This method cannot be called from a remote computer.

WU_E_INVALID_OPERATION

The EndSearch method returns WU_E_INVALID_OPERATION if EndSearch has already been called for the search job.

WU_E_INVALID_CRITERIA

An invalid criteria was encountered during a search.

 

Remarks

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.

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

See also

IUpdateSearcher

 

 

Community Additions

ADD
Show:
© 2014 Microsoft