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

Agrega un elemento de escritorio al Escritorio activo después de mostrar interfaces de usuario que confirmen la adición del elemento de escritorio, la comprobación de los permisos de zona de seguridad y la pregunta si el usuario quiere crear una suscripción.

Sintaxis

HRESULT AddDesktopItemWithUI(
  [in, optional] HWND        hwnd,
  [in]           LPCOMPONENT pcomp,
                 DWORD       dwReserved
);

Parámetros

[in, optional] hwnd

Tipo: HWND

Identificador de la ventana primaria. Si es NULL, el elemento de escritorio se agrega sin mostrar ninguna interfaz de usuario, de acuerdo con los permisos de zona de seguridad correspondientes. Para obtener más información, consulte Acerca de las zonas de seguridad de direcciones URL.

[in] pcomp

Tipo: LPCOMPONENT

Dirección de la estructura COMPONENT que contiene los detalles del elemento de escritorio que se va a agregar.

dwReserved

Tipo: DWORD

Valor entero largo sin signo que contiene las marcas que controlan cómo se agrega el elemento de escritorio. Puede ser uno de los siguientes valores.

DTI_ADDUI_DEFAULT

Realice la acción predeterminada. Idéntico al uso de cero.

DTI_ADDUI_DISPSUBWIZARD

Active el Asistente para suscripciones para permitir que el usuario se suscriba a este elemento de escritorio.

DTI_ADDUI_POSITIONITEM

Indique al sistema que examine la estructura COMPPOS pasada al miembro cpPos de la estructura COMPONENT para asegurarse de que los valores están dentro de límites razonables. Este valor se agregó para Internet Explorer 5.

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	Si se ha establecido la marca ADDURL_SILENT , el elemento de escritorio se ha agregado correctamente o ya existe en El escritorio activo. De lo contrario, el elemento de escritorio se ha agregado correctamente.

Comentarios

Este método crea una segunda instancia de Active Desktop para agregar el elemento de escritorio, por lo que el elemento de escritorio no aparece en la instancia actual. La aplicación debe llamar al método IUnknown::Release en esta interfaz IActiveDesktop y, a continuación, usar la función CoCreateInstance para recuperar el objeto Active Desktop con el componente recién agregado.

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