Metode ICategoryProvider::EnumCategories (shobjidl_core.h)

Mendapatkan enumerator untuk daftar GUID yang mewakili kategori.

Sintaks

HRESULT EnumCategories(
  [out] IEnumGUID **penum
);

Parameter

[out] penum

Jenis: IEnumGUID**

Ketika metode ini kembali, berisi alamat penunjuk ke antarmuka IEnumGUID yang menentukan daftar GUID yang mewakili kategori.

Nilai kembali

Jenis: HRESULT

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

Keterangan

Dalam kasus objek tampilan folder sistem, ICategoryProvider::EnumCategories digunakan untuk mendapatkan kategori tambahan yang tidak terkait dengan kolom. Ketika daftar GUID kategori dikembalikan melalui penum, UI mencoba mengambil nama setiap kategori. Nama tersebut kemudian ditampilkan sebagai pilihan kategori. Dalam kasus Windows XP, pilihan tersebut muncul di menu Susun Ikon Menurut folder.

Persyaratan

Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	shobjidl_core.h (termasuk Shobjidl.h)
DLL	Shell32.dll