IDesktopWallpaper::Enable 메서드(shobjidl_core.h)

바탕 화면 배경을 사용하거나 사용하지 않도록 설정합니다.

구문

HRESULT Enable(
  [in] BOOL enable
);

[in] enable

데스크톱 배경을 사용하도록 설정하려면 TRUE, FALSE 를 사용하여 사용하지 않도록 설정합니다.

메서드가 성공하면 S_OK를 반환하고, 그렇지 않으면 다음을 포함하여 HRESULT 오류 코드를 반환합니다.

반환 코드	설명
S_FALSE	바탕 화면 배경 화면은 이미 이 호출을 통해 요청하는 상태입니다.
E_FILE_NOT_FOUND	배경이 활성화될 때 사용되는 바탕 화면 배경 화면이 예상 위치에서 누락되었습니다. SetWallpaper를 호출하여 새 배경 화면을 지정합니다.

이 메서드는 일반적으로 성능상의 이유로 바탕 화면 배경을 사용하지 않도록 설정하기 위해 호출됩니다.

바탕 화면 배경을 사용하지 않도록 설정하면 단색이 그 자리에 표시됩니다. 특정 색을 얻거나 설정하려면 GetBackgroundColor 및 SetBackgroundColor 메서드를 사용합니다.

참고IDesktopWallpaper_SetWallpaper 또는 IDesktopWallpaper_SetSlideshow 메서드를 호출하면 현재 이 메서드를 통해 사용하지 않도록 설정된 경우에도 바탕 화면 배경이 활성화됩니다.