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 錯誤碼。

備註

uFlags 可以是 BrowseObjectwFlags 參數中定義的任何EXPLORER_BROWSER_FILL_FLAGS或任何旗標，但指出導覽的旗標除外。

這個方法會呼叫 GetIDList 並流覽至傳回的 pidl。其運作方式與 IExplorerBrowser：：BrowseToIDList 相同，但標點不能是 NULL。標準用法是流覽至 IShellFolder 或 IShellItem。如果傳入的物件無法流覽，則會傳回錯誤。可流覽至實作 IPersistFolder2 或 IPersistIDList 的物件。

IExplorerBrowser 的第一個流覽是同步的。之後，所有導覽都是異步的。因此，如果您正確設定擱置的流覽，則呼叫 IExplorerBrowser：：BrowseToObject 將會成功，但這不保證導覽會成功。為了通知成功和失敗，客戶端應該實作 IExplorerBrowserEvents，並在 OnNavigationComplete 和 OnNavigationFailed 中適當地回應。

規格需求

需求	值
最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]
目標平台	Windows
標頭	shobjidl_core.h (包括 Shobjidl.h)

共用方式為