ICategoryProvider::EnumCategories-Methode (shobjidl_core.h)

Ruft den Enumerator für die Liste der GUIDs ab, die Kategorien darstellen.

Syntax

HRESULT EnumCategories(
  [out] IEnumGUID **penum
);

Parameter

[out] penum

Typ: IEnumGUID**

Wenn diese Methode zurückgibt, enthält die Adresse eines Zeigers auf eine IEnumGUID-Schnittstelle , die eine Liste von GUIDs angibt, die Kategorien darstellen.

Rückgabewert

Typ: HRESULT

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

Hinweise

Im Fall des Systemordnersichtobjekts wird ICategoryProvider::EnumCategories verwendet, um zusätzliche Kategorien abzurufen, die keiner Spalte zugeordnet sind. Wenn die Liste der Kategorie-GUIDs über den Penum zurückgegeben wird, versucht die Benutzeroberfläche, den Namen jeder Kategorie abzurufen. Dieser Name wird dann als Kategorieauswahl angezeigt. Im Fall von Windows XP wird diese Option im Menü "Symbole anordnen nach " des Ordners angezeigt.

Anforderungen

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 (einschließlich Shobjidl.h)
DLL	Shell32.dll