Méthode IUpdateSearcher ::BeginSearch (wuapi.h)

Commence l’exécution d’une recherche asynchrone de mises à jour. La recherche utilise les options de recherche actuellement configurées.

Syntaxe

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

Paramètres

[in] criteria

Chaîne qui spécifie les critères de recherche.

[in] onCompleted

Interface ISearchCompletedCallback appelée lorsqu’une opération de recherche asynchrone est terminée.

[in] state

État spécifique à l’appelant qui est retourné par la propriété AsyncState de l’interface ISearchJob .

[out] retval

Interface ISearchJob qui représente l’opération en cours qui peut être en attente.

L’appelant transmet la valeur retournée à la méthode EndSearch pour effectuer une opération de recherche.

Valeur retournée

Retourne S_OK en cas de réussite. Sinon, retourne un code d’erreur COM ou Windows.

Cette méthode peut également retourner les codes d’erreur suivants.

Remarques

Pour obtenir une description complète de la syntaxe des critères de recherche, consultez Rechercher.

En guise d’alternative à l’implémentation de l’interface ISearchCompletedCallback , vous pouvez utiliser un script pour implémenter une routine de rappel de n’importe quel identificateur avec DISPID 0 sur un objet Automation. Le type du paramètre onCompleted est IUnknown*.

Lorsque vous utilisez une API WUA asynchrone dans votre application, vous devrez peut-être implémenter un mécanisme de délai d’attente. Pour plus d’informations sur l’exécution d’opérations WUA asynchrones, consultez Instructions pour les opérations WUA asynchrones.

Configuration requise

Voir aussi

IUpdateSearcher