Metode IExplorerBrowser::BrowseToIDList (shobjidl_core.h)

Menelusuri ke penunjuk ke daftar pengidentifikasi item (PIDL)

Sintaks

HRESULT BrowseToIDList(
  [in] PCUIDLIST_RELATIVE pidl,
  [in] UINT               uFlags
);

Parameter

[in] pidl

Jenis: PCUIDLIST_RELATIVE

Penunjuk ke ITEMIDLIST const (daftar pengidentifikasi item) yang menentukan lokasi objek sebagai tujuan untuk dinavigasi. Parameter ini bisa NULL. Untuk informasi selengkapnya, lihat Keterangan.

[in] uFlags

Jenis: UINT

Bendera yang menentukan kategori pidl. Ini memengaruhi 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 ke 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 apa pun 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.

Menampilkan nilai

Jenis: HRESULT

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

Keterangan

Parameter pidl mungkin NULL jika bendera yang ditentukan dalam uFlags menunjukkan navigasi melalui TravelLog bawaan, yaitu SBSP_NAVIGATEBACK atau SBSP_NAVIGATEFORWARD.

Metode ini hanya mendukung subset bendera SBSP yang tercantum dalam file shobjidl.h. Akibatnya, metode ini mengembalikan E_INVALIDARG jika SBSP_NEWBROWSER atau SBSP_EXPLOREMODE ditentukan dalam uFlags.

Persyaratan

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)

Lihat juga

JelajahiObject

IExplorerBrowser