Méthode IShellFolderView::AddObject (shlobj_core.h)

Article
08/26/2023

[AddObject est disponible pour une utilisation dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il peut être modifié ou indisponible dans les versions suivantes.]

Ajoute un élément à la vue.

Syntaxe

HRESULT AddObject(
  [in]  PUITEMID_CHILD pidl,
  [out] UINT           *puItem
);

Paramètres

[in] pidl

Type : PUITEMID_CHILD

Pointeur vers un ItemID qui spécifie l’élément à ajouter à la vue.

[out] puItem

Type : UINT*

Pointeur vers une valeur qui, lorsque cette méthode retourne correctement, reçoit la position d’index de l’élément ajouté.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Si vous appelez immédiatement IShellFolderView::GetObject avec cet index, vous obtiendrez une copie du ITEMID_CHILD que vous avez ajouté. Toutefois, la position d’index d’un élément peut changer au fil du temps, de sorte que le code ne peut pas approuver qu’un index spécifique retourne toujours le même ITEMID_CHILD.

Les éléments ajoutés via cette méthode peuvent être supprimés de la vue par la source de données à tout moment.

Configuration requise


Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	shlobj_core.h

Partager via