Metodo IActiveDesktop::AddDesktopItemWithUI (shlobj_core.h)

  • Articolo

Aggiunge un elemento desktop a Active Desktop dopo aver visualizzato le interfacce utente che confermano l'aggiunta dell'elemento desktop, la verifica delle autorizzazioni dell'area di sicurezza e la richiesta di creazione di una sottoscrizione da parte dell'utente.

Sintassi

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

Parametri

[in, optional] hwnd

Tipo: HWND

Handle della finestra padre. Se NULL, l'elemento desktop viene aggiunto senza visualizzare alcuna interfaccia utente, in base alle autorizzazioni corrispondenti per l'area di sicurezza. Per altre informazioni, vedere Informazioni sulle zone di sicurezza degli URL.

[in] pcomp

Tipo: LPCOMPONENT

Indirizzo della struttura COMPONENT contenente i dettagli dell'elemento desktop da aggiungere.

dwReserved

Tipo: DWORD

Valore intero lungo senza segno che contiene i flag che controllano la modalità di aggiunta dell'elemento desktop. Può essere uno dei valori seguenti.

DTI_ADDUI_DEFAULT

Eseguire l'azione predefinita. Identico all'uso di zero.

DTI_ADDUI_DISPSUBWIZARD

Attivare la procedura guidata della sottoscrizione per consentire all'utente di sottoscrivere questo elemento desktop.

DTI_ADDUI_POSITIONITEM

Indicare al sistema di esaminare la struttura COMPPOS passata al membro cpPos della struttura COMPONENT per garantire che i valori siano entro limiti ragionevoli. Questo valore è stato aggiunto per Internet Explorer 5.

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 esiste già in Active Desktop.
E_INVAILDARG
 Uno o più parametri non sono validi.
S_OK
 Se il flag 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

Questo metodo crea una seconda istanza di Active Desktop per aggiungere l'elemento desktop, quindi l'elemento desktop non viene visualizzato nell'istanza corrente. L'applicazione deve chiamare il metodo IUnknown::Release su questa interfaccia IActiveDesktop e quindi usare la funzione CoCreateInstance per recuperare l'oggetto Active Desktop con il componente appena aggiunto.

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

Utilizzo dell'oggetto Desktop attivo