IShellFolderView::RefreshObject-Methode (shlobj_core.h)

Artikel
03/02/2024

[RefreshObject ist für die Verwendung in den im Abschnitt Anforderungen angegebenen Betriebssystemen verfügbar. Sie kann in nachfolgenden Versionen geändert oder nicht verfügbar sein.]

Zeichnet das angegebene Element neu.

Syntax

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

Parameter

[in] pidl

Typ: PUITEMID_CHILD

Das element, das neu gezeichnet werden soll.

[out] puItem

Typ: UINT*

Ein Zeiger auf einen Wert, der den Index des neu gezeichneten Elements empfängt, wenn diese Methode erfolgreich zurückgibt. Sie können diesen Wert verwenden, um IShellFolderView::GetObject aufzurufen, um die PITEMID_CHILD abzurufen, die Sie gerade neu gezeichnet haben.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Wenn Sie IShellFolderView::GetObject sofort mit dem von puItem zurückgegebenen Index aufrufen, erhalten Sie eine Kopie der ITEMID_CHILD, die Sie neu wiederherstellen. Die Indexposition eines Elements kann sich jedoch im Laufe der Zeit ändern, sodass code nicht darauf vertrauen kann, dass ein bestimmter Index immer denselben ITEMID_CHILD zurückgibt.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shlobj_core.h

Freigeben über