Поделиться через

Метод IShellFolderView::UpdateObject (shlobj_core.h)

  • Статья

[UpdateObject доступен для использования в операционных системах, указанных в разделе Требования. Он может быть изменен или недоступен в последующих версиях.]

Заменяет элемент в представлении другим элементом.

Синтаксис

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

Параметры

[in] pidlOld

Тип: PUITEMID_CHILD

Исходный элемент.

[in] pidlNew

Тип: PUITEMID_CHILD

Новый элемент.

[out] puItem

Тип: UINT*

При возврате этим методом содержит указатель на индекс замененного элемента. Это значение можно использовать для последующего вызова IShellFolderView::GetObject , чтобы вернуть только что добавленную PITEMID_CHILD.

Возвращаемое значение

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

При немедленном вызове IShellFolderView::GetObject с индексом, возвращенным puItem, вы получите копию добавленного ITEMID_CHILD. Однако позиция индекса элемента со временем может меняться, поэтому код не может доверять тому, что какой-либо определенный индекс всегда возвращает один и тот же ITEMID_CHILD.

Изменения, внесенные с помощью этого метода, могут быть отменены в представлении источником данных в любое время.

Требования

Требование Значение
Минимальная версия клиента Windows XP [только классические приложения]
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header shlobj_core.h