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

Article
08/26/2023

Ajoute un élément de bureau à Active Desktop après avoir affiché les interfaces utilisateur qui confirment l’ajout de l’élément de bureau, en vérifiant les autorisations de zone de sécurité et en demandant si l’utilisateur souhaite créer un abonnement.

Syntaxe

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

Paramètres

[in, optional] hwnd

Type : HWND

Handle de la fenêtre parente. Si la valeur est NULL, l’élément de bureau est ajouté sans afficher d’interface utilisateur, conformément aux autorisations de zone de sécurité correspondantes. Pour plus d’informations, consultez À propos des zones de sécurité d’URL.

[in] pcomp

Type : LPCOMPONENT

Adresse de la structure COMPONENT contenant les détails de l’élément de bureau à ajouter.

dwReserved

Type : DWORD

Valeur entière longue non signée qui contient les indicateurs qui contrôlent la façon dont l’élément de bureau est ajouté. Il peut s’agir de l’une des valeurs suivantes.

DTI_ADDUI_DEFAULT

Effectuez l’action par défaut. Identique à l’utilisation de zéro.

DTI_ADDUI_DISPSUBWIZARD

Activez l’Assistant Abonnement pour permettre à l’utilisateur de s’abonner à cet élément de bureau.

DTI_ADDUI_POSITIONITEM

Demandez au système d’examiner la structure COMPPOS transmise au membre cpPos de la structure COMPONENT pour s’assurer que les valeurs se trouvent dans des limites raisonnables. Cette valeur a été ajoutée pour Internet Explorer 5.

Valeur retournée

Type : HRESULT

Retourne l’une des valeurs suivantes.

Code de retour	Description
E_FAIL	Échec de l’ajout de l’élément de bureau ou d’une instance de l’élément de bureau existe déjà sur Active Desktop.
E_INVAILDARG	Un ou plusieurs des paramètres n’étaient pas valides.
S_OK	Si l’indicateur ADDURL_SILENT a été défini, l’élément de bureau a été ajouté avec succès ou il existe déjà sur Active Desktop. Sinon, l’élément de bureau a été ajouté avec succès.

Remarques

Cette méthode crée une deuxième instance d’Active Desktop pour ajouter l’élément de bureau, de sorte que l’élément de bureau n’apparaît pas dans le instance actuel. L’application doit appeler la méthode IUnknown ::Release sur cette interface IActiveDesktop , puis utiliser la fonction CoCreateInstance pour récupérer l’objet Active Desktop avec le composant nouvellement ajouté.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel, Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shlobj_core.h
DLL	Shell32.dll (version 4.71 ou ultérieure)

Voir aussi

IActiveDesktop

Utilisation de l’objet Active Desktop

Partager via