IShellIconOverlayIdentifier::IsMemberOf-Methode (shobjidl_core.h)

  • Artikel

Gibt an, ob dem Symbol eines Shell-Objekts eine Symbolüberlagerung hinzugefügt werden soll.

Syntax

HRESULT IsMemberOf(
  [in] LPCWSTR pwszPath,
       DWORD   dwAttrib
);

Parameter

[in] pwszPath

Typ: PCWSTR

Eine Unicode-Zeichenfolge, die den vollqualifizierten Pfad des Shell-Objekts enthält.

dwAttrib

Art: DWORD

Die Attribute des Objekts. Eine vollständige Liste der Dateiattribute und der zugehörigen Flags finden Sie unter Dateiattributekonstanten.

Rückgabewert

Typ: HRESULT

Diese Methode gibt eine der folgenden Rückgaben zurück:

Rückgabecode BESCHREIBUNG
S_OK
 Die Symbolüberlagerung sollte angezeigt werden.
S_FALSE
 Die Symbolüberlagerung sollte nicht angezeigt werden.
E_FAIL
 Fehler beim Vorgang.

Hinweise

Die Shell ruft diese Methode auf, um zu bestimmen, ob die Symbolüberlagerung eines Handlers für ein bestimmtes Objekt angezeigt werden soll. Symbolüberlagerungshandler sind normalerweise für die Verwendung mit einer bestimmten Gruppe von Dateien vorgesehen. Ein typisches Beispiel ist ein Dateityp, der durch eine bestimmte Dateinamenerweiterung identifiziert wird. Ein Symbolüberlagerungshandler fordert möglicherweise eine Symbolüberlagerung für alle Elemente des Dateityps an. Einige Handler fordern nur dann eine Symbolüberlagerung an, wenn sich ein Element des Dateityps in einem bestimmten Zustand befindet. Symbolüberlagerungshandler können jedoch ihre Symbolüberlagerung für jedes gewünschte Objekt anfordern.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000 Professional, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shobjidl_core.h (shlobj.h einschließen)
DLL Shell32.dll (Version 5.0 oder höher)

Weitere Informationen

IShellIconOverlayIdentifier