Metode IAppPublisher::GetCategories (shappmgr.h)

Mengambil struktur yang mencantumkan kategori yang disediakan oleh penerbit aplikasi.

Sintaks

HRESULT GetCategories(
  [out] APPCATEGORYINFOLIST *pAppCategoryList
);

Parameter

[out] pAppCategoryList

Jenis: APPCATEGORYINFOLIST*

Penunjuk ke struktur APPCATEGORYINFOLIST . Anggota cCategory struktur ini mengembalikan jumlah kategori yang didukung. Anggota pCategoryInfo mengembalikan pointer ke array struktur APPCATEGORYINFO . Array ini berisi semua kategori yang didukung penerbit aplikasi dan harus dialokasikan menggunakan CoTaskMemAlloc dan dibebaskan menggunakan CoTaskMemFree.

Mengembalikan nilai

Jenis: HRESULT

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

Keterangan

Tambahkan/Hapus Program Panel Kontrol Aplikasi meneruskan ID yang dikembalikan untuk kategori ke metode IAppPublisher::EnumApps untuk mengidentifikasi kategori mana yang akan dijumlahkan.

Contoh

Contoh berikut menunjukkan cara menghitung ukuran array struktur APPCATEGORYINFO yang dikembalikan oleh IAppPublisher::GetCategories.

size_t CategoryListArraySize = sizeof(APPCATEGORYINFO) * pInfoList->cCategory;

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP, Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	shappmgr.h

Lihat juga

APPCATEGORYINFO

APPCATEGORYINFOLIST

IAppPublisher