IAppPublisher::GetCategories メソッド (shappmgr.h)

アプリケーション発行元によって提供されるカテゴリを一覧表示する構造体を取得します。

構文

HRESULT GetCategories(
  [out] APPCATEGORYINFOLIST *pAppCategoryList
);

パラメーター

[out] pAppCategoryList

型: APPCATEGORYINFOLIST*

APPCATEGORYINFOLIST 構造体へのポインター。 この構造体の cCategory メンバーは、サポートされているカテゴリの数を返します。 pCategoryInfo メンバーは、APPCATEGORYINFO 構造体の配列へのポインターを返します。 この配列には、アプリケーション発行元がサポートするすべてのカテゴリが含まれており、 CoTaskMemAlloc を使用して割り当て、 CoTaskMemFree を使用して解放する必要があります。

戻り値

型: HRESULT

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

注釈

Add/Remove Programs コントロール パネル Application は、カテゴリに対して返された ID を IAppPublisher::EnumApps メソッドに渡して、列挙するカテゴリを識別します。

例

次の例は、IAppPublisher::GetCategories によって返される APPCATEGORYINFO 構造体の配列のサイズを計算する方法を示しています。

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

要件

要件	値
サポートされている最小のクライアント	Windows XP、Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム	Windows
ヘッダー	shappmgr.h

こちらもご覧ください

APPCATEGORYINFO

APPCATEGORYINFOLIST

IAppPublisher