Compartir a través de

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

  • Artículo

Agrega un elemento de escritorio.

Sintaxis

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

Parámetros

[in] pcomp

Tipo: LPCCOMPONENT

Puntero a la estructura COMPONENT que especifica el elemento que se va a agregar.

dwReserved

Tipo: DWORD

Reservado. Debe establecerse en cero.

Valor devuelto

Tipo: HRESULT

Devuelve uno de los valores siguientes.

Código devuelto Descripción
E_FAIL
 No se pudo agregar el elemento de escritorio o ya existe una instancia del elemento de escritorio en el escritorio activo.
E_INVAILDARG
 Uno o varios de los parámetros no eran válidos.
S_OK
 El elemento de escritorio se ha agregado correctamente.

Comentarios

El elemento de escritorio se agrega al escritorio, pero no lo guarda en el registro. La aplicación cliente debe llamar a IActiveDesktop::ApplyChanges por separado para actualizar el registro.

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

Consulte también

IActiveDesktop

Uso del objeto de escritorio activo