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

Agrega el elemento de escritorio asociado a la dirección URL especificada.

Sintaxis

HRESULT AddUrl(
  [in, optional] HWND        hwnd,
  [in]           PCWSTR      pszSource,
  [in]           LPCOMPONENT pcomp,
                 DWORD       dwFlags
);

Parámetros

[in, optional] hwnd

Tipo: HWND

Identificador de la ventana primaria de la interfaz de usuario.

[in] pszSource

Tipo: PCWSTR

Puntero a una cadena que contiene la dirección URL del elemento de escritorio.

[in] pcomp

Tipo: LPCOMPONENT

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

dwFlags

Tipo: DWORD

Valor entero largo sin signo que controla este método. Se puede establecer en ADDURL_SILENT para agregar un elemento de escritorio sin mostrar ninguna interfaz de usuario.

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

De forma predeterminada, este método mostrará alguna interfaz de usuario y, a continuación, agregará el elemento de escritorio al escritorio activo. Al igual que IActiveDesktop::AddDesktopItem, la aplicación cliente debe llamar a IActiveDesktop::ApplyChanges para guardar los cambios en 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