Partager via

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

  • Article

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.

Code de retour Description
E_POINTER
 Une valeur de paramètre n’est pas valide ou NULL.
E_ACCESSDENIED
 Cette méthode ne peut pas être appelée à partir d’un ordinateur distant.

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

Condition requise Valeur
Client minimal pris en charge Windows XP, Windows 2000 Professionnel avec SP3 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2003, Windows 2000 Server avec SP3 [applications de bureau uniquement]
Plateforme cible Windows
En-tête wuapi.h
Bibliothèque Wuguid.lib
DLL Wuapi.dll

Voir aussi

IUpdateSearcher