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

[UpdateObject peut être utilisé dans les systèmes d’exploitation spécifiés dans la section Configuration requise. Il peut être modifié ou indisponible dans les versions suivantes.]

Remplace un élément dans une vue par un autre élément.

Syntaxe

HRESULT UpdateObject(
  [in]  PUITEMID_CHILD pidlOld,
  [in]  PUITEMID_CHILD pidlNew,
  [out] UINT           *puItem
);

Paramètres

[in] pidlOld

Type : PUITEMID_CHILD

Élément d’origine.

[in] pidlNew

Type : PUITEMID_CHILD

Nouvel élément.

[out] puItem

Type : UINT*

Lorsque cette méthode est retournée, contient un pointeur vers l’index de l’élément qui a été remplacé. Vous pouvez utiliser cette valeur pour appeler IShellFolderView ::GetObject ultérieurement afin de récupérer les PITEMID_CHILD que vous venez d’ajouter.

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 l’index retourné par puItem, 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 faire confiance au fait qu’un index spécifique retourne toujours le même ITEMID_CHILD.

Les modifications apportées par le biais de cette méthode peuvent être ignorées dans la vue par la source de données à tout moment.

Configuration requise