IDesktopWallpaper：：Enable 方法 (shobjidl_core.h)

啟用或停用桌面背景。

語法

HRESULT Enable(
  [in] BOOL enable
);

[in] enable

TRUE 表示啟用桌面背景， FALSE 以停用它。

如果此方法成功，則會傳回 S_OK。否則，它會傳回 HRESULT 錯誤碼，包括下列內容。

傳回碼	Description
S_FALSE	桌面桌布已處於您透過此通話要求的狀態。
E_FILE_NOT_FOUND	當背景啟用時，從其預期位置遺失時所使用的桌面背景。呼叫 SetWallpaper 以指定新的桌布。

基於效能考慮，通常會呼叫這個方法以停用桌面背景。

當桌面背景停用時，就會在其位置顯示純色。若要取得或設定特定色彩，請使用 GetBackgroundColor 和 SetBackgroundColor 方法。

注意即使目前透過此方法停用， IDesktopWallpaper_SetWallpaper或 IDesktopWallpaper_SetSlideshow 方法的呼叫仍會啟用桌面背景。