RefreshObject method

IShellFolderView::RefreshObject method

[RefreshObject is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions.]

Redraws the given item.

Syntax


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

Parameters

pidl [in]

Type: PUITEMID_CHILD

The item to be redrawn.

puItem [out]

Type: UINT*

A pointer to a value that, when this method returns successfully, receives the index of the item that was redrawn. You can use this value to call IShellFolderView::GetObject to retrieve the PITEMID_CHILD that you just redrew.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

If you immediately call IShellFolderView::GetObject with the index returned by puItem, you will get a copy of the ITEMID_CHILD that you redrew. However, the index position of an item may change over time, so code cannot trust that any specific index always returns the same ITEMID_CHILD.

Requirements

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

End of client support

Windows Vista

End of server support

Windows Server 2008

 

 

Show:
© 2016 Microsoft