IUpdateServiceManager::RegisterServiceWithAU-Methode (wuapi.h)

  • Artikel

Registriert einen Dienst bei Automatic Updates.

Syntax

HRESULT RegisterServiceWithAU(
  [in] BSTR serviceID
);

Parameter

[in] serviceID

Ein Bezeichner für den zu registrierenden Dienst.

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_DS_UNKNOWNSERVICE
 Ein Versuch, einen unbekannten Dienst zu registrieren.
WU_E_DS_NEEDWINDOWSSERVICE
 Der Windows Update Dienst konnte nicht entfernt werden.
WU_E_INVALID_OPERATION
 Der Computer konnte nicht auf die Updatewebsite zugreifen, oder der Status der automatischen Updates konnte nicht geändert werden.

Hinweise

Diese Methode gibt WU_E_DS_UNKNOWNSERVICE zurück, wenn der zu registrierende Dienst der automatischen Updates unbekannt ist.

Diese Methode gibt WU_E_INVALID_OPERATION zurück, wenn die Methode mit einer ungültigen Dienst-ID aufgerufen wird. Diese Methode gibt auch WU_E_INVALID_OPERATION zurück, wenn die Dienst-ID gültig ist, der Dienst sich jedoch nicht bei Automatic Updates registrieren kann. Das heißt, die angeforderte Änderung des Status von Automatic Updates steht im Widerspruch zu den Spezifikationen in der Autorisierungsschrankdatei (z. B. ist die CanRegisterWithAU-Eigenschaft auf FALSE festgelegt). Ein Fehler wird von der WinVerifyTrust-Funktion zurückgegeben, wenn die Autorisierungsschrankdatei nicht signiert wurde.

Diese Methode gibt WU_E_DS_NEEDWINDOWSSERVICE zurück, wenn Sie versuchen, den Windows Update-Dienst zu entfernen.

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