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

Статья
03/02/2024

Переход к объекту .

Синтаксис

HRESULT BrowseToObject(
  [in] IUnknown *punk,
  [in] UINT     uFlags
);

Параметры

[in] punk

Тип: IUnknown*

Указатель на объект для перехода. Если не удается просмотреть объект, возвращается значение ошибки.

[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 .

Этот метод вызывает GetIDList и переходит к возвращенной pidl. Он работает так же, как IExplorerBrowser::BrowseToIDList, за исключением того, что punk не может иметь значение NULL. Стандартное использование — переход к IShellFolder или IShellItem. Если не удается просмотреть переданный объект, будет возвращена ошибка. Объект, который можно просматривать с помощью, реализует IPersistFolder2 или IPersistIDList.

Первая навигация в IExplorerBrowser является синхронной. После этого все навигации будут асинхронными. В результате вызовы IExplorerBrowser::BrowseToObject будут успешными , если вы правильно настроили ожидающую навигацию, но это не гарантирует успешное выполнение навигации. Чтобы получать сведения об успешном и неудачном выполнении, клиенты должны реализовать IExplorerBrowserEvents и соответствующим образом реагировать в OnNavigationComplete и OnNavigationFailed.

Требования

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

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