Fungsi SHOpenFolderAndSelectItems (shlobj_core.h)

Membuka jendela Windows Explorer dengan item tertentu dalam folder tertentu yang dipilih.

Sintaks

SHSTDAPI SHOpenFolderAndSelectItems(
  [in]           PCIDLIST_ABSOLUTE     pidlFolder,
                 UINT                  cidl,
  [in, optional] PCUITEMID_CHILD_ARRAY apidl,
                 DWORD                 dwFlags
);

Parameter

[in] pidlFolder

Jenis: PCIDLIST_ABSOLUTE

Penunjuk ke daftar ID item yang sepenuhnya memenuhi syarat yang menentukan folder.

cidl

Jenis: UINT

Jumlah item dalam array pilihan, apidl. Jika cidl adalah nol, maka pidlFolder harus menunjuk ke ITEMIDLIST yang sepenuhnya ditentukan yang menjelaskan satu item untuk dipilih. Fungsi ini membuka folder induk dan memilih item tersebut.

[in, optional] apidl

Jenis: PCUITEMID_CHILD_ARRAY

Penunjuk ke array struktur PIDL, yang masing-masing merupakan item untuk dipilih dalam folder target yang dirujuk oleh pidlFolder.

dwFlags

Jenis: DWORD

Bendera opsional. Di bawah Windows XP parameter ini diabaikan. Di Windows Vista, bendera berikut ditentukan.

OFASI_EDIT (0x0001)

Pilih item dan letakkan namanya dalam mode edit. Bendera ini hanya dapat digunakan ketika satu item sedang dipilih. Untuk beberapa pilihan item, pilihan diabaikan.

OFASI_OPENDESKTOP (0x0002)

Pilih item atau item pada desktop, bukan di jendela Windows Explorer. Perhatikan bahwa jika desktop dikaburkan di belakang jendela yang terbuka, desktop tidak akan terlihat.

Nilai kembali

Jenis: HRESULT

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

Keterangan

CoInitialize atau CoInitializeEx harus dipanggil sebelum menggunakan SHOpenFolderAndSelectItems. Tidak melakukannya menyebabkan SHOpenFolderAndSelectItems gagal.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	shlobj_core.h (termasuk Shlobj.h)
Pustaka	Shell32.lib
DLL	Shell32.dll (versi 6.0 atau yang lebih baru)