ICategorizer::GetCategory メソッド (shobjidl_core.h)

識別子の一覧に関連付けられているカテゴリの一覧を取得します。

構文

HRESULT GetCategory(
  [in]  UINT                  cidl,
  [in]  PCUITEMID_CHILD_ARRAY apidl,
  [out] DWORD                 *rgCategoryIds
);

パラメーター

[in] cidl

型: UINT

項目識別子リスト配列内の項目の数。

[in] apidl

種類: PCUITEMID_CHILD_ARRAY*

cidl 項目識別子リスト ポインターの配列へのポインター。

[out] rgCategoryIds

種類: DWORD*

このメソッドが戻るとき、 には cidl カテゴリ識別子の配列へのポインターが含まれます。

戻り値

種類: HRESULT

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

注釈

ICategorizer::GetCategory メソッドは、項目識別子リスト (PIDL) へのポインターの配列を受け取り、カテゴリ識別子の配列を入力します。

大事な 値 -1 は無効なカテゴリ識別子です。
 

要件

要件
サポートされている最小のクライアント Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー shobjidl_core.h (Shobjidl.h を含む)
[DLL] Shell32.dll