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

Article
03/04/2024

[RefreshObject 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.]

Redessine l’élément donné.

Syntaxe

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

Paramètres

[in] pidl

Type : PUITEMID_CHILD

Élément à redessiner.

[out] puItem

Type : UINT*

Pointeur vers une valeur qui, lorsque cette méthode retourne correctement, reçoit l’index de l’élément qui a été redessiné. Vous pouvez utiliser cette valeur pour appeler IShellFolderView ::GetObject pour récupérer le PITEMID_CHILD que vous venez de redessiner.

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 redessiné. 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.

Configuration requise

Condition requise	Valeur
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