Compartir a través de

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

  • Artículo

Modifica el elemento de escritorio.

Sintaxis

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

Parámetros

[in, out] pcomp

Tipo: LPCCOMPONENT

Dirección de la estructura COMPONENT que contiene las modificaciones. Se modificará el elemento de escritorio asociado al miembro wszSource de la estructura.

dwFlags

Tipo: DWORD

Valor entero largo sin signo que contiene las marcas usadas para la modificación. Puede ser uno de los siguientes valores.

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

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.

Comentarios

La aplicación cliente debe llamar a IActiveDesktop::ApplyChanges por separado para actualizar el registro. Por ejemplo, para cambiar el nombre descriptivo, llame primero a esta función con COMP_ELEM_FRIENDLYNAME o COMP_ELEM_ALL en el miembro dwFlags de COMPONENT. A continuación, llame a IActiveDesktop::ApplyChanges.

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 Shlobj_core.h (versión 4.71 o posterior)

Consulte también

IActiveDesktop