IDesktopWallpaper::Enable-Methode (shobjidl_core.h)

Artikel
03/04/2024

Aktiviert oder deaktiviert den Desktophintergrund.

Syntax

HRESULT Enable(
  [in] BOOL enable
);

Parameter

[in] enable

TRUE , um den Desktophintergrund zu aktivieren, FALSE , um ihn zu deaktivieren.

Rückgabewert

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben, einschließlich des folgenden.

Rückgabecode	Beschreibung
S_FALSE	Das Desktophintergrundbild befindet sich bereits in dem Zustand, den Sie über diesen Aufruf anfordern.
E_FILE_NOT_FOUND	Das Desktophintergrundbild, das verwendet wird, wenn der Hintergrund aktiviert ist, fehlt an der erwarteten Position. Rufen Sie SetWallpaper auf, um ein neues Hintergrundbild anzugeben.

Hinweise

Diese Methode wird normalerweise aufgerufen, um den Desktophintergrund aus Leistungsgründen zu deaktivieren.

Wenn der Desktophintergrund deaktiviert ist, wird an ihrer Stelle eine Volltonfarbe angezeigt. Verwenden Sie zum Abrufen oder Festlegen der spezifischen Farbe die Methoden GetBackgroundColor und SetBackgroundColor .

Hinweis Ein Aufruf der methoden IDesktopWallpaper_SetWallpaper oder IDesktopWallpaper_SetSlideshow aktiviert den Desktophintergrund, auch wenn er derzeit über diese Methode deaktiviert ist.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 8 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2012 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shobjidl_core.h (einschließlich Shobjidl.h)

Weitere Informationen

IDesktopWallpaper

Share via