Metodo IActiveDesktop::AddUrl (shlobj_core.h)

  • Articolo

Aggiunge l'elemento desktop associato all'URL specificato.

Sintassi

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

Parametri

[in, optional] hwnd

Tipo: HWND

Handle alla finestra padre per l'interfaccia utente.

[in] pszSource

Tipo: PCWSTR

Puntatore a una stringa contenente l'URL dell'elemento desktop.

[in] pcomp

Tipo: LPCOMPONENT

Puntatore alla struttura COMPONENT contenente i dettagli dell'elemento desktop da aggiungere.

dwFlags

Tipo: DWORD

Valore intero lungo senza segno che controlla questo metodo. Può essere impostato su ADDURL_SILENT per aggiungere un elemento desktop senza visualizzare alcuna interfaccia utente.

Valore restituito

Tipo: HRESULT

Restituisce uno dei valori seguenti.

Codice restituito Descrizione
E_FAIL
 Impossibile aggiungere l'elemento desktop o un'istanza dell'elemento desktop già presente in Active Desktop.
E_INVAILDARG
 Uno o più parametri non sono validi.
S_OK
 Se il flag di ADDURL_SILENT è stato impostato, l'elemento desktop è stato aggiunto correttamente o esiste già in Active Desktop. In caso contrario, l'elemento desktop è stato aggiunto correttamente.

Commenti

Per impostazione predefinita, questo metodo visualizzerà un'interfaccia utente e quindi aggiungerà l'elemento desktop a Active Desktop. Come IActiveDesktop::AddDesktopItem, l'applicazione client deve chiamare IActiveDesktop::ApplyChanges per avere le modifiche salvate nel Registro di sistema.

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional, Windows XP [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione shlobj_core.h
DLL Shell32.dll (versione 4.71 o successiva)

Vedi anche

IActiveDesktop

Uso dell'oggetto Desktop attivo