ICategoryProvider::GetDefaultCategory-Methode (shobjidl_core.h)

Artikel
03/02/2024

Ermöglicht dem Ordner das Überschreiben der Standardgruppierung.

Syntax

HRESULT GetDefaultCategory(
  [out] GUID       *pguid,
  [out] SHCOLUMNID *pscid
);

Parameter

[out] pguid

Typ: GUID*

Wird nicht verwendet.

[out] pscid

Typ: SHCOLUMNID*

Wenn diese Methode zurückgibt, enthält einen Zeiger auf eine SHCOLUMNID-Struktur .

Rückgabewert

Typ: HRESULT

Gibt bei erfolgreicher Ausführung S_OK oder andernfalls einen Fehlerwert zurück, einschließlich der folgenden:

Rückgabecode	Beschreibung
S_FALSE	Es gibt keine Standardgruppe.

Hinweise

ICategoryProvider::GetDefaultCategory gibt eine SHCOLUMNID-Struktur zurück, die vom Standardkategorisierer verwendet wird. Die Methode gibt S_FALSE zurück, wenn eine Standardgruppe nicht unterstützt wird.

ICategoryProvider::GetDefaultCategory wird nur aufgerufen, wenn ein Ordner zum ersten Mal geöffnet wird. Danach wird die Gruppierungsauswahl des Benutzers im Eigenschaftenbehälter zwischengespeichert, um den Zustand der Ansicht zu speichern. Um einen Aufruf von ICategoryProvider::GetDefaultCategory nach dem ersten Öffnen des Ordners zu erzwingen, müssen die Registrierungsschlüssel Shell und ShellNoRoam gelöscht werden. Sie befinden sich am folgenden Speicherort.

HKEY_CURRENT_USER
   Software
      Microsoft
         Windows
            Shell
            ShellNoRoam

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

Share via