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

Article
03/04/2024

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

Partager via