Metodo IUpdateSearcher::BeginSearch (wuapi.h)

Inizia l'esecuzione di una ricerca asincrona per gli aggiornamenti. La ricerca usa le opzioni di ricerca attualmente configurate.

Sintassi

HRESULT BeginSearch(
  [in]  BSTR       criteria,
  [in]  IUnknown   *onCompleted,
  [in]  VARIANT    state,
  [out] ISearchJob **retval
);

Parametri

[in] criteria

Stringa che specifica i criteri di ricerca.

[in] onCompleted

Interfaccia ISearchCompletedCallback chiamata quando viene completata un'operazione di ricerca asincrona.

[in] state

Stato specifico del chiamante restituito dalla proprietà AsyncState dell'interfaccia ISearchJob .

[out] retval

Interfaccia ISearchJob che rappresenta l'operazione corrente che potrebbe essere in sospeso.

Il chiamante passa il valore restituito al metodo EndSearch per completare un'operazione di ricerca.

Valore restituito

Restituisce S_OK se riuscito. In caso contrario, restituisce un codice di errore COM o Windows.

Questo metodo può anche restituire i codici di errore seguenti.

Commenti

Per una descrizione completa della sintassi dei criteri di ricerca, vedere Ricerca.

In alternativa all'implementazione dell'interfaccia ISearchCompletedCallback , è possibile usare uno script per implementare una routine di callback di qualsiasi identificatore con DISPID 0 in un oggetto di automazione. Il tipo del parametro onCompleted è IUnknown*.

Quando si usa qualsiasi API WUA asincrona nell'app, potrebbe essere necessario implementare un meccanismo di timeout. Per altre informazioni su come eseguire operazioni WUA asincrone, vedere Linee guida per operazioni WUA asincrone.

Requisiti

Vedi anche

IUpdateSearcher