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

Ajoute l’élément de bureau associé à l’URL spécifiée.

Syntaxe

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

Paramètres

[in, optional] hwnd

Type : HWND

Handle de la fenêtre parente de l’interface utilisateur.

[in] pszSource

Type : PCWSTR

Pointeur vers une chaîne qui contient l’URL de l’élément de bureau.

[in] pcomp

Type : LPCOMPONENT

Pointeur vers la structure COMPONENT qui contient les détails de l’élément de bureau à ajouter.

dwFlags

Type : DWORD

Valeur d’entier long non signé qui contrôle cette méthode. Peut être défini sur ADDURL_SILENT pour ajouter un élément de bureau sans afficher d’interfaces utilisateur.

Valeur retournée

Type : HRESULT

Retourne l’une des valeurs suivantes.

Code de retour	Description
E_FAIL	Impossible d’ajouter l’élément de bureau ou un 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

Par défaut, cette méthode affiche une interface utilisateur, puis ajoute l’élément de bureau à Active Desktop. Comme IActiveDesktop ::AddDesktopItem, l’application cliente doit appeler IActiveDesktop ::ApplyChanges pour que les modifications soient enregistrées dans le Registre.

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