IExplorerBrowser：：BrowseToObject 方法 (shobjidl_core.h)

瀏覽至物件。

語法

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 中適當地回應。

規格需求