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

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

  • Статья

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

Добавляет элемент в представление.

Синтаксис

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

Параметры

[in] pidl

Тип: PUITEMID_CHILD

Указатель на ItemID, указывающий элемент, добавляемый в представление.

[out] puItem

Тип: UINT*

Указатель на значение, которое при успешном возврате этого метода получает позицию индекса добавленного элемента.

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

Тип: HRESULT

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

Комментарии

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

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

Требования

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