Compartilhar via

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

  • Artigo

Adiciona um item da área de trabalho.

Sintaxe

HRESULT AddDesktopItem(
  [in] LPCCOMPONENT pcomp,
       DWORD        dwReserved
);

Parâmetros

[in] pcomp

Tipo: LPCCOMPONENT

Um ponteiro para a estrutura COMPONENT que especifica o item a ser adicionado.

dwReserved

Tipo: DWORD

Reservado. Deve ser definido como zero.

Retornar valor

Tipo: HRESULT

Retorna um dos valores a seguir.

Código de retorno Descrição
E_FAIL
 Falha ao adicionar o item da área de trabalho ou já existe uma instância do item da área de trabalho na Área de Trabalho Ativa.
E_INVAILDARG
 Um ou mais dos parâmetros eram inválidos.
S_OK
 O item da área de trabalho foi adicionado com êxito.

Comentários

O item da área de trabalho é adicionado à área de trabalho, mas não o salva no Registro. O aplicativo cliente deve chamar IActiveDesktop::ApplyChanges separadamente para atualizar o registro.

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)

Confira também

IActiveDesktop

Usando o objeto Da Área de Trabalho Ativa