Metode IShellFolder::GetAttributesOf (shobjidl_core.h)

Artikel
03/15/2023

Mendapatkan atribut dari satu atau beberapa objek file atau folder yang terkandung dalam objek yang diwakili oleh IShellFolder.

Sintaks

HRESULT GetAttributesOf(
  [in]      UINT                  cidl,
  [in]      PCUITEMID_CHILD_ARRAY apidl,
  [in, out] SFGAOF                *rgfInOut
);

Parameter

[in] cidl

Jenis: UINT

Jumlah item untuk mengambil atribut.

[in] apidl

Jenis: PCUITEMID_CHILD_ARRAY*

Alamat array pointer ke struktur ITEMIDLIST , yang masing-masing secara unik mengidentifikasi item relatif terhadap folder induk. Setiap struktur ITEMIDLIST harus berisi tepat satu struktur SHITEMID diikuti dengan nol penghentian.

[in, out] rgfInOut

Jenis: SFGAOF*

Penunjuk ke satu nilai ULONG yang, pada entri, berisi atribut SFGAO bitwise yang diminta aplikasi panggilan. Saat keluar, nilai ini berisi atribut yang diminta yang umum untuk semua item yang ditentukan.

Nilai kembali

Jenis: HRESULT

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

Keterangan

Untuk mengoptimalkan operasi ini, jangan kembalikan bendera yang tidak ditentukan.

Untuk objek folder, atribut SFGAO_BROWSABLE menyiratkan bahwa klien dapat mengikat objek ini seperti yang ditunjukkan dalam formulir umum di sini.

IShellFolder::BindToObject(..., pidl, IID_IShellFolder, &psfItem);

Klien kemudian dapat membuat IShellView pada item tersebut melalui pernyataan ini.

psfItem->CreateViewObject(..., IID_IShellView,...);

Atribut SFGAO_DROPTARGET menyiratkan bahwa klien dapat mengikat instans IDropTarget untuk folder ini dengan memanggil IShellFolder::GetUIObjectOf seperti yang ditunjukkan di sini.

IShellFolder::GetUIObjectOf(hwnd, 1, &pidl, IID_IDropTarget, NULL, &pv)

Atribut SFGAO_NONENUMERATED menunjukkan item yang tidak dikembalikan oleh enumerator yang dibuat oleh metode IShellFolder::EnumObjects .

Persyaratan


Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	shobjidl_core.h (termasuk Shobjidl.h)
DLL	Shell32.dll (versi 4.0 atau yang lebih baru)

Lihat juga

IShellFolder

IShellFolder2

Bagikan melalui