Metode IExplorerBrowser::BrowseToObject (shobjidl_core.h)

Artikel
03/04/2024

Menelusuri objek.

Sintaks

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

Parameter

[in] punk

Jenis: IUnknown*

Penunjuk ke objek untuk dijelajahi. Jika objek tidak dapat ditelusuri, nilai kesalahan dikembalikan.

[in] uFlags

Jenis: UINT

Bendera yang menentukan kategori pidl. Ini mempengaruhi bagaimana navigasi dicapai. Harus berupa nilai nol, atau kombinasi bitwise dari nilai berikut.

SBSP_ABSOLUTE

PIDL absolut, relatif terhadap desktop.

SBSP_RELATIVE

PIDL relatif, relatif terhadap folder saat ini.

SBSP_PARENT

Telusuri folder induk, abaikan PIDL.

SBSP_NAVIGATEBACK

Navigasi kembali, abaikan PIDL.

SBSP_NAVIGATEFORWARD

Navigasi ke depan, abaikan PIDL.

SBSP_KEEPWORDWHEELTEXT

Windows Vista dan yang lebih baru. Bendera ini menunjukkan bahwa teks pencarian yang dimasukkan oleh WordWheel (kotak Pencarian di Windows Explorer) harus dipertahankan selama navigasi ini, sehingga item di lokasi baru difilter dengan cara yang sama seperti difilter di lokasi sebelumnya.

Nilai kembali

Jenis: HRESULT

Jika metode ini berhasil, metode ini mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

uFlags mungkin salah satu dari EXPLORER_BROWSER_FILL_FLAGS atau bendera apa pun yang ditentukan dalam parameter wFlagsBrowseObject, kecuali untuk bendera yang menunjukkan navigasi.

Metode ini memanggil GetIDList dan menelusuri pidl yang dikembalikan. Ini beroperasi dengan cara yang sama seperti IExplorerBrowser::BrowseToIDList, kecuali bahwa punk tidak boleh NULL. Penggunaan standar adalah menelusuri ke IShellFolder atau IShellItem. Kesalahan akan dikembalikan jika objek yang diteruskan tidak dapat ditelusuri. Objek yang dapat dijelajahi melalui mengimplementasikan IPersistFolder2 atau IPersistIDList.

Navigasi pertama IExplorerBrowser sinkron. Setelah itu, semua navigasi tidak sinkron. Akibatnya, panggilan ke IExplorerBrowser::BrowseToObject akan berhasil jika Anda mengatur navigasi yang tertunda dengan benar, tetapi itu tidak menjamin navigasi akan berhasil. Untuk mendapatkan informasi tentang keberhasilan dan kegagalan, klien harus menerapkan IExplorerBrowserEvents dan merespons dengan tepat di OnNavigationComplete dan OnNavigationFailed.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	shobjidl_core.h (termasuk Shobjidl.h)

Bagikan melalui