ICategorizer::GetCategory-Methode (shobjidl_core.h)

Artikel
08/26/2023

Ruft eine Liste von Kategorien ab, die einer Liste von Bezeichnern zugeordnet sind.

Syntax

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

Parameter

[in] cidl

Typ: UINT

Die Anzahl der Elemente in einem Elementbezeichnerlistenarray.

[in] apidl

Typ: PCUITEMID_CHILD_ARRAY*

Ein Zeiger auf ein Array von Cidl-Elementbezeichnerlistenzeigern.

[out] rgCategoryIds

Typ: DWORD*

Wenn diese Methode zurückgibt, enthält einen Zeiger auf ein Array von Cidl-Kategoriebezeichnern.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Die ICategorizer::GetCategory-Methode akzeptiert ein Array von Zeigern auf Elementbezeichnerlisten (PIDLs) und füllt ein Array von Kategoriebezeichnern aus.

Wichtig Der Wert -1 ist ein ungültiger Kategoriebezeichner.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	shobjidl_core.h (shobjidl.h einschließen)
DLL	Shell32.dll

Share via