Metode ICategoryProvider::GetDefaultCategory (shobjidl_core.h)

Memungkinkan folder untuk mengambil alih pengelompokan default.

Sintaks

HRESULT GetDefaultCategory(
  [out] GUID       *pguid,
  [out] SHCOLUMNID *pscid
);

Parameter

[out] pguid

Jenis: GUID*

Tidak digunakan.

[out] pscid

Jenis: SHCOLUMNID*

Ketika metode ini kembali, berisi penunjuk ke struktur SHCOLUMNID .

Mengembalikan nilai

Jenis: HRESULT

Mengembalikan S_OK jika berhasil, atau nilai kesalahan jika tidak, termasuk yang berikut ini:

Menampilkan kode	Deskripsi
S_FALSE	Tidak ada grup default.

Keterangan

ICategoryProvider::GetDefaultCategory mengembalikan struktur SHCOLUMNID yang digunakan oleh categorizer default. Metode mengembalikan S_FALSE jika grup default tidak didukung.

ICategoryProvider::GetDefaultCategory hanya dipanggil saat folder pertama kali dibuka. Setelah itu, pilihan pengelompokan pengguna di-cache di tas properti yang menyimpan status tampilan. Untuk memaksa panggilan ke ICategoryProvider::GetDefaultCategory setelah folder pertama kali dibuka, kunci registri Shell dan ShellNoRoam harus dihapus. Mereka ditemukan di lokasi berikut.

HKEY_CURRENT_USER
   Software
      Microsoft
         Windows
            Shell
            ShellNoRoam

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	shobjidl_core.h (termasuk Shobjidl.h)
DLL	Shell32.dll