Metodo IActiveDesktop::GetWallpaper (shlobj_core.h)

  • Articolo

Ottiene lo sfondo corrente.

Sintassi

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

Parametri

[out] pwszWallpaper

Tipo: PWSTR

Quando termina, questo metodo contiene un puntatore a un buffer Unicode con terminazione Null che contiene il nome file dello sfondo.

cchWallpaper

Tipo: UINT

Dimensioni della stringa pwszWallpaper , in caratteri.

dwFlags

Tipo: DWORD

Tipo di carta da parati da ottenere. Uno dei valori seguenti.

AD_GETWP_BMP (0x00000000)

Ottenere una bitmap.

AD_GETWP_IMAGE (0x00000001)

Ottenere un'immagine.

AD_GETWP_LAST_APPLIED (0x00000002)

Ottiene il tipo di carta da parati applicata per l'ultima volta.

Valore restituito

Tipo: HRESULT

Se questo metodo ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional, Windows XP [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione shlobj_core.h
DLL Shell32.dll (versione 4.71 o successiva)