Método IDesktopWallpaper::GetWallpaper (shobjidl_core.h)
Obtiene el fondo de pantalla de escritorio actual.
Sintaxis
HRESULT GetWallpaper(
[in] LPCWSTR monitorID,
[out] LPWSTR *wallpaper
);
Parámetros
[in] monitorID
Identificador del monitor. Este valor se puede obtener a través de GetMonitorDevicePathAt.
Este valor se puede establecer en NULL. En ese caso, si se muestra una sola imagen de fondo de pantalla en todos los monitores del sistema, el método devuelve correctamente. Si este valor se establece en NULL y los monitores diferentes muestran fondos de pantalla diferentes o se está ejecutando una presentación, el método devuelve S_FALSE y una cadena vacía en el parámetro wallpaper .
[out] wallpaper
La dirección de un puntero a un búfer que, cuando este método vuelve correctamente, recibe la ruta de acceso al archivo de imagen de fondo de pantalla. Tenga en cuenta que esta imagen podría mostrarse actualmente en todos los monitores del sistema, no solo en el monitor especificado en el parámetro monitorID .
Esta cadena estará vacía si no se muestra ninguna imagen de fondo de pantalla o si un monitor muestra un color sólido. La cadena también estará vacía si se produce un error en el método.
Valor devuelto
Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.
Requisitos
| Cliente mínimo compatible | Windows 8 [solo aplicaciones de escritorio] |
| Servidor mínimo compatible | Windows Server 2012 [solo aplicaciones de escritorio] |
| Plataforma de destino | Windows |
| Encabezado | shobjidl_core.h (include Shobjidl.h) |