IUpdateSearcher::EndSearch-Methode (wuapi.h)

  • Artikel

Schließt eine asynchrone Suche nach Updates ab.

Syntax

HRESULT EndSearch(
  [in]  ISearchJob    *searchJob,
  [out] ISearchResult **retval
);

Parameter

[in] searchJob

Die ISearchJob-Schnittstelle , die von der BeginSearch-Methode zurückgegeben wird.

[out] retval

Eine ISearchResult-Schnittstelle , die Folgendes enthält:

  • Das Ergebnis eines Vorgangs
  • Eine Sammlung von Updates, die den Suchkriterien entsprechen

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
S_OK
 Eine asynchrone Suche nach Updates ist erfolgreich.
WU_E_LEGACYSERVER
 Sie können nicht nach Updates suchen, wenn die ServerSelection-Eigenschaft von IUpdateSearcher auf ssManagedServer oder auf ssDefault festgelegt ist und der verwaltete Server auf einem Computer ein Server von Microsoft Software Update Services (SUS) 1.0 ist.
E_POINTER
 Ein Parameterwert ist ungültig oder NULL.
E_ACCESSDENIED
 Diese Methode kann nicht von einem Remotecomputer aufgerufen werden.
WU_E_INVALID_OPERATION
 Die EndSearch-Methode gibt WU_E_INVALID_OPERATION zurück, wenn EndSearch bereits für den Suchauftrag aufgerufen wurde.
WU_E_INVALID_CRITERIA
 Während einer Suche wurde ein ungültiges Kriterium gefunden.

Hinweise

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

   
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