Compartilhar via

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

  • Artigo

Obtém o papel de parede atual.

Sintaxe

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

Parâmetros

[out] pwszWallpaper

Tipo: PWSTR

Quando esse método retorna, contém um ponteiro para um buffer Unicode encerrado em nulo que contém o nome do arquivo do papel de parede.

cchWallpaper

Tipo: UINT

O tamanho da cadeia de caracteres pwszWallpaper , em caracteres.

dwFlags

Tipo: DWORD

O tipo de papel de parede a ser obtido. Um dos valores a seguir.

AD_GETWP_BMP (0x00000000)

Obtenha um bitmap.

AD_GETWP_IMAGE (0x00000001)

Obter uma imagem.

AD_GETWP_LAST_APPLIED (0x00000002)

Obtenha o tipo de papel de parede que foi aplicado pela última vez.

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional, Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho shlobj_core.h
DLL Shell32.dll (versão 4.71 ou posterior)