IUpdateSearcher::BeginSearch-Methode (wuapi.h)

Artikel
03/04/2024

Beginnt mit der Ausführung einer asynchronen Suche nach Updates. Die Suche verwendet die derzeit konfigurierten Suchoptionen.

Syntax

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

Parameter

[in] criteria

Eine Zeichenfolge, die die Suchkriterien angibt.

[in] onCompleted

Eine ISearchCompletedCallback-Schnittstelle , die aufgerufen wird, wenn ein asynchroner Suchvorgang abgeschlossen ist.

[in] state

Der aufruferspezifische Zustand, der von der AsyncState-Eigenschaft der ISearchJob-Schnittstelle zurückgegeben wird.

[out] retval

Eine ISearchJob-Schnittstelle , die den aktuellen Vorgang darstellt, der möglicherweise aussteht.

Der Aufrufer übergibt den zurückgegebenen Wert an die EndSearch-Methode , um einen Suchvorgang abzuschließen.

Rückgabewert

Gibt bei erfolgreicher Ausführung S_OK zurück. Andernfalls wird ein COM- oder Windows-Fehlercode zurückgegeben.

Diese Methode kann auch die folgenden Fehlercodes zurückgeben.

Rückgabecode	Beschreibung
E_POINTER	Ein Parameterwert ist ungültig oder NULL.
E_ACCESSDENIED	Diese Methode kann nicht von einem Remotecomputer aufgerufen werden.

Hinweise

Eine vollständige Beschreibung der Syntax der Suchkriterien finden Sie unter Suchen.

Alternativ zur Implementierung der ISearchCompletedCallback-Schnittstelle können Sie ein Skript verwenden, um eine Rückrufroutine eines beliebigen Bezeichners mit DISPID 0 für ein Automatisierungsobjekt zu implementieren. Der Typ des onCompleted-Parameters ist IUnknown*.

Wenn Sie eine asynchrone WUA-API in Ihrer App verwenden, müssen Sie möglicherweise einen Timeoutmechanismus implementieren. Weitere Informationen zum Ausführen asynchroner WUA-Vorgänge finden Sie unter Richtlinien für asynchrone WUA-Vorgänge.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP, Windows 2000 Professional mit SP3 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003, Windows 2000 Server mit SP3 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	wuapi.h
Bibliothek	Wuguid.lib
DLL	Wuapi.dll

Weitere Informationen

IUpdateSearcher

Freigeben über