IUpdateServiceManager::AddScanPackageService-Methode (wuapi.h)

Artikel
03/04/2024

Registriert ein Scanpaket als Dienst bei Windows Update Agent (WUA) und gibt dann eine IUpdateService-Schnittstelle zurück.

Syntax

HRESULT AddScanPackageService(
  [in]  BSTR           serviceName,
  [in]  BSTR           scanFileLocation,
  [in]  LONG           flags,
  [out] IUpdateService **ppService
);

Parameter

[in] serviceName

Ein beschreibender Name für den Überprüfungspaketdienst.

[in] scanFileLocation

Der Pfad der von Microsoft signierten Scandatei, die als Dienst registriert werden muss.

[in] flags

Bestimmt, wie die Dienstregistrierung des Überprüfungspakets entfernt wird.

Mögliche Werte finden Sie unter UpdateServiceOption.

[out] ppService

Ein Zeiger auf eine IUpdateService-Schnittstelle , die Dienstregistrierungsinformationen enthält.

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_INVALIDARG	Ein Parameterwert ist ungültig.
E_ACCESSDENIED	Diese Methode kann nicht von einem Remotecomputer aufgerufen werden.
WU_E_INVALID_OPERATION	Der Computer konnte nicht auf den Updatestandort zugreifen.

Hinweise

Sie können die ID des Diensts in Suchvorgängen verwenden, indem Sie die ID als ServiceID-Eigenschaft der IUpdateSearcher-Schnittstelle übergeben.

Um Ressourcen freizugeben, entfernen Sie den Dienst, nachdem er nicht mehr benötigt wird. Verwenden Sie die RemoveService-Methode , um den Dienst zu entfernen.

Rufen Sie nicht die RegisterServiceWithAU-Methode für den Dienst auf, den die AddScanPackageService-Methode registriert.

Der von AddScanPackageService zurückgegebene Dienst befindet sich in der Sammlung von Diensten, die von der Services-Eigenschaft der IUpdateServiceManager-Schnittstelle zurückgegeben werden. Dieser Dienst verfügt über die spezielle IsScanPackageService-Eigenschaft .

WinVerifyTrust gibt einen Fehler zurück, wenn die Autorisierungs-Cab nicht signiert ist.

Diese Methode gibt WU_E_INVALID_OPERATION zurück, wenn das Objekt, das die Schnittstelle implementiert, gesperrt wurde.

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

IUpdateServiceManager

Freigeben über