Метод IExplorerBrowser::BrowseToIDList (shobjidl_core.h)

Статья
08/26/2023

Поиск указателя на список идентификаторов элементов (PIDL)

Синтаксис

HRESULT BrowseToIDList(
  [in] PCUIDLIST_RELATIVE pidl,
  [in] UINT               uFlags
);

Параметры

[in] pidl

Тип: PCUIDLIST_RELATIVE

Указатель на const ITEMIDLIST (список идентификаторов элементов), указывающий расположение объекта в качестве назначения для перехода. Этот параметр может принимать значение NULL. Дополнительные сведения см. в подразделе "Примечания".

[in] uFlags

Тип: UINT

Флаг , указывающий категорию pidl. Это влияет на способ навигации. Должно быть нулевое значение или побитовое сочетание следующих значений.

SBSP_ABSOLUTE

Абсолютный ИДЕНТИФИКАТОР PIDL относительно рабочего стола.

SBSP_RELATIVE

Относительный ИДЕНТИФИКАТОР PIDL относительно текущей папки.

SBSP_PARENT

Перейдите к родительской папке и игнорируйте PIDL.

SBSP_NAVIGATEBACK

Вернитесь назад, проигнорируйте PIDL.

SBSP_NAVIGATEFORWARD

Перейдите вперед, проигнорируйте PIDL.

SBSP_KEEPWORDWHEELTEXT

Windows Vista и более поздних версий. Этот флаг указывает, что любой текст поиска, введенный WordWheel (поле поиска в Windows Обозреватель), должен сохраняться во время навигации, чтобы элементы в новом расположении фильтрулись так же, как и в предыдущем расположении.

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

Тип: HRESULT

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

Этот метод поддерживает только подмножество флагов SBSP, перечисленных в файле shobjidl.h. Следовательно, этот метод возвращает E_INVALIDARG, если SBSP_NEWBROWSER или SBSP_EXPLOREMODE указаны в uFlags.

Требования


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

См. также раздел

BrowseObject

IExplorerBrowser

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