IShellBrowser：：BrowseObject 方法 (shobjidl_core.h)

發行項
03/15/2023

通知 Windows 檔案總管流覽至另一個資料夾。

語法

HRESULT BrowseObject(
  PCUIDLIST_RELATIVE pidl,
  UINT               wFlags
);

參數

pidl

類型： PCUIDLIST_RELATIVE

ITEMIDLIST (專案識別碼清單的位址) 結構，指定物件的位置。此值取決於 wFlags 參數中設定的旗標或旗標。

wFlags

類型： UINT

旗標，指定要流覽的資料夾。它可以是零或一或多個下列值。

這些旗標會指定是否要建立另一個視窗。

SBSP_DEFBROWSER (0x0000)

使用預設行為，它會 (使用者設定來建立新的視窗或就地流覽) 。在大部分情況下，呼叫應用程式應該使用此旗標。

SBSP_SAMEBROWSER

流覽至另一個具有相同 Windows 檔案總管視窗的資料夾。

SBSP_NEWBROWSER

為指定的資料夾建立另一個視窗。

下列旗標會指定模式。如果指定了SBSP_SAMEBROWSER，或已指定SBSP_DEFBROWSER，而且使用者已選取 [ 就地流覽]，則會忽略這些值。

SBSP_DEFMODE

使用目前的視窗。

SBSP_OPENMODE

為新的流覽視窗指定任何資料夾樹狀結構。如果目前的瀏覽器不符合流覽物件呼叫的SBSP_OPENMODE，則會開啟新的視窗。

SBSP_EXPLOREMODE

指定新流覽視窗的資料夾樹狀結構。如果目前的瀏覽器不符合流覽物件呼叫的SBSP_EXPLOREMODE，則會開啟新的視窗。

SBSP_HELPMODE

不支援。請勿使用。

SBSP_NOTRANSFERHIST

請勿將流覽歷程記錄傳送至新的視窗。

下列旗標會指定 pidl 參數的類別。

SBSP_ABSOLUTE

相對於桌面的絕對 PIDL。

SBSP_RELATIVE

相對於目前資料夾的相對 PIDL。

SBSP_PARENT

流覽父資料夾，忽略 PIDL。

SBSP_NAVIGATEBACK

返回流覽，忽略 PIDL。

SBSP_NAVIGATEFORWARD

向前流覽，忽略 PIDL。

SBSP_ALLOW_AUTONAVIGATE (0x00010000)

啟用自動流覽。

下列旗標會指定模式。

SBSP_KEEPSAMETEMPLATE (0x00020000)

Windows Vista 和更新版本。不支援。請勿使用。

SBSP_KEEPWORDWHEELTEXT (0x00040000)

Windows Vista 和更新版本。流覽而不清除搜尋專案欄位。

SBSP_ACTI加值稅E_NOFOCUS (0x00080000)

Windows Vista 和更新版本。在不將焦點設定為新檢視的預設行為的情況下流覽。

下列旗標可控制歷程記錄如何因流覽而操作。

SBSP_CALLERUNTRUSTED (0x00800000)

Microsoft Internet Explorer 6 Service Pack 2 (SP2) 和更新版本。導覽可能是由網頁起始，其中腳本程式碼已存在於本機系統上。

SBSP_TRUSTFIRSTDOWNLOAD (0x01000000)

Microsoft Internet Explorer 6 Service Pack 2 (SP2) 和更新版本。新視窗是使用者起始動作的結果。如果新視窗立即嘗試下載內容，請信任新的視窗。

SBSP_UNTRUSTEDFORDOWNLOAD (0x02000000)

Microsoft Internet Explorer 6 Service Pack 2 (SP2) 和更新版本。視窗正在巡覽至不受信任的非 HTML 檔案。如果使用者嘗試下載檔案，則不允許下載。

SBSP_NOAUTOSELECT

隱藏曆程記錄窗格中的選取範圍。

SBSP_WRITENOHISTORY

在 [歷程記錄殼層] 資料夾中，寫入此導覽的歷程記錄。

SBSP_CREATENOHISTORY (0x00100000)

0x00100000。 Windows 7 和更新版本。請勿將新專案新增至旅遊記錄。當使用者在搜尋方塊中輸入搜尋字詞並後續精簡查詢時，瀏覽器會向前流覽，但不會新增額外的移動記錄專案。

SBSP_TRUSTEDFORACTIVEX (0x10000000)

Microsoft Internet Explorer 6 Service Pack 2 (SP2) 和更新版本。流覽應該允許 ActiveX 提示。

SBSP_FEEDNAVIGATION (0x20000000)

Windows Internet Explorer 7 和更新版本。如果目前登錄設定允許，請為瀏覽器提供巡覽目的地。

SBSP_REDIRECT (0x40000000)

啟用重新導向至另一個 URL。

SBSP_INITIATEDBYHLINKFRAME (0x80000000)

SBSP_PLAYNOSOUND (0x00200000)

Windows 7 和更新版本。請勿在搜尋方塊中針對每個按鍵進行流覽完整音效。

傳回值

類型： HRESULT

如果此方法成功，則會傳回 S_OK。否則，它會傳回 HRESULT 錯誤碼。

備註

檢視可以使用這個方法來強制 Windows 檔案總管流覽至命名空間中的特定位置。這些通常是檢視中包含的資料夾。

範例

IShellBrowser* psb;
hr = IUnknown_QueryService(punkSite, SID_STopLevelBrowser, IID_PPV_ARGS(&psb));

if (SUCCEEDED(hr))
{
    hr = psb->BrowseObject(pidlSearch, SBSP_DEFBROWSER | SBSP_ABSOLUTE);
    psb->Release();
}

規格需求


最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows 2000 Server [僅限傳統型應用程式]
目標平台	Windows
標頭	shobjidl_core.h (包括 Shobjidl.h)
Dll	Shell32.dll (4.0 版或更新版本)

另請參閱

IShellBrowser

Share via