Compartir a través de

Método IActiveDesktop::GetWallpaper (shlobj_core.h)

  • Artículo

Obtiene el fondo de pantalla actual.

Sintaxis

HRESULT GetWallpaper(
  [out] PWSTR pwszWallpaper,
        UINT  cchWallpaper,
        DWORD dwFlags
);

Parámetros

[out] pwszWallpaper

Tipo: PWSTR

Cuando este método vuelve, contiene un puntero a un búfer Unicode terminado en null que contiene el nombre de archivo del fondo de pantalla.

cchWallpaper

Tipo: UINT

Tamaño de la cadena pwszWallpaper , en caracteres.

dwFlags

Tipo: DWORD

Tipo de fondo de pantalla que se va a obtener. Uno de los siguientes valores.

AD_GETWP_BMP (0x00000000)

Obtener un mapa de bits.

AD_GETWP_IMAGE (0x00000001)

Obtener una imagen.

AD_GETWP_LAST_APPLIED (0x00000002)

Obtiene el tipo de fondo de pantalla que se aplicó por última vez.

Valor devuelto

Tipo: HRESULT

Si este método se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Requisitos

Requisito Value
Cliente mínimo compatible Windows 2000 Professional, Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado shlobj_core.h
Archivo DLL Shell32.dll (versión 4.71 o posterior)