IDesktopWallpaper::GetWallpaper 메서드(shobjidl_core.h)
현재 바탕 화면 배경 화면을 가져옵니다.
구문
HRESULT GetWallpaper(
[in] LPCWSTR monitorID,
[out] LPWSTR *wallpaper
);
매개 변수
[in] monitorID
모니터의 ID입니다. 이 값은 GetMonitorDevicePathAt를 통해 가져올 수 있습니다.
이 값은 NULL로 설정할 수 있습니다. 이 경우 시스템의 모든 모니터에 단일 배경 화면 이미지가 표시되면 메서드가 성공적으로 반환됩니다. 이 값이 NULL 로 설정되어 있고 다른 모니터가 다른 배경 화면을 표시하거나 슬라이드 쇼가 실행되는 경우 메서드는 배경 화면 매개 변수에 S_FALSE 빈 문자열을 반환합니다.
[out] wallpaper
이 메서드가 성공적으로 반환될 때 배경 화면 이미지 파일의 경로를 수신하는 버퍼에 대한 포인터의 주소입니다. 이 이미지는 현재 monitorID 매개 변수에 지정된 모니터뿐만 아니라 시스템의 모든 모니터에 표시될 수 있습니다.
배경 화면 이미지가 표시되지 않거나 모니터가 단색을 표시하는 경우 이 문자열은 비어 있습니다. 메서드가 실패하면 문자열도 비어 있습니다.
반환 값
메서드가 성공하면 S_OK를 반환하고, 성공하지 않으면 HRESULT 오류 코드를 반환합니다.
요구 사항
| 지원되는 최소 클라이언트 | Windows 8 [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2012 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | shobjidl_core.h(Shobjidl.h 포함) |