Метод INameSpaceTreeControl::AppendRoot (shobjidl_core.h)

Статья
08/26/2023

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

Синтаксис

HRESULT AppendRoot(
  [in] IShellItem       *psiRoot,
  [in] SHCONTF          grfEnumFlags,
  [in] NSTCROOTSTYLE    grfRootStyle,
  [in] IShellItemFilter *pif
);

Параметры

[in] psiRoot

Тип: IShellItem*

Указатель на добавляемый элемент оболочки.

[in] grfEnumFlags

Тип: SHCONTF

Перечисляет качества корня и всех его дочерних элементов. Одно или несколько значений типа SHCONTF. Эти флаги можно комбинировать с помощью побитового ИЛИ.

[in] grfRootStyle

Тип: NSTCROOTSTYLE

Задает стиль добавляемого корня. Одно или несколько из следующих значений:

NSTCRS_VISIBLE (0x0000)

Корень отображается так же, как и элементы. Взаимоисключающие с NSTCRS_HIDDEN.

NSTCRS_HIDDEN (0x0001)

Корень скрыт, чтобы были видны только дочерние элементы. Взаимоисключающие с NSTCRS_VISIBLE.

NSTCRS_EXPANDED (0x0002)

Корневой каталог расширяется после инициализации.

[in] pif

Тип: IShellItemFilter*

Указатель на IShellItemFilter , который позволяет фильтровать отображаемые элементы в дереве. Если он указан, каждый элемент можно настроить с помощью флага SHCONTF . Если фильтр не требуется, это значение может иметь значение NULL .

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

Тип: HRESULT

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

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	shobjidl_core.h (включая Shobjidl.h)

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