Compartilhar via

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

  • Artigo

Modifica o item da área de trabalho.

Sintaxe

HRESULT ModifyDesktopItem(
  [in, out] LPCCOMPONENT pcomp,
            DWORD        dwFlags
);

Parâmetros

[in, out] pcomp

Tipo: LPCCOMPONENT

O endereço da estrutura COMPONENT que contém as modificações. O item da área de trabalho associado ao membro wszSource da estrutura será modificado.

dwFlags

Tipo: DWORD

Um valor inteiro longo sem sinal que contém os sinalizadores usados para a modificação. Esse pode ser um dos valores a seguir.

COMP_ELEM_ALL

COMP_ELEM_CHECKED

COMP_ELEM_CURITEMSTATE

COMP_ELEM_FRIENDLYNAME

COMP_ELEM_NOSCROLL

COMP_ELEM_ORIGINAL_CSI

COMP_ELEM_POS_LEFT

COMP_ELEM_POS_TOP

COMP_ELEM_POS_ZINDEX

COMP_ELEM_RESTORED_CSI

COMP_ELEM_SIZE_HEIGHT

COMP_ELEM_SIZE_WIDTH

COMP_ELEM_SOURCE

COMP_ELEM_TYPE

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.

Comentários

O aplicativo cliente deve chamar IActiveDesktop::ApplyChanges separadamente para atualizar o registro. Por exemplo, para alterar o nome amigável, primeiro chame essa função com COMP_ELEM_FRIENDLYNAME ou COMP_ELEM_ALL no membro dwFlags de COMPONENT. Em seguida, chame IActiveDesktop::ApplyChanges.

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 Shlobj_core.h (versão 4.71 ou posterior)

Confira também

IActiveDesktop