IShellIconOverlayIdentifier::GetPriority-Methode (shobjidl_core.h)

Gibt die Priorität einer Symbolüberlagerung an.

Syntax

HRESULT GetPriority(
  [out] int *pPriority
);

Parameter

[out] pPriority

Typ: int*

Die Adresse eines Werts, der die Priorität des Überlagerungsbezeichners angibt. Mögliche Werte reichen von 0 bis 100, wobei null die höchste Priorität hat.

Rückgabewert

Typ: HRESULT

Gibt bei erfolgreicher Ausführung S_OK oder andernfalls einen COM-Fehlercode zurück.

Hinweise

Wenn für ein Objekt mehrere Symbolüberlagerungen verfügbar sind, wird die Überlagerung mit der höchsten Priorität ausgewählt. Die Shell verfügt über eine Reihe interner Regeln, die die Priorität für viele Fälle bestimmen. Der von GetPriority zurückgegebene Wert wird für die Fälle verwendet, in denen die internen Regeln der Shell nicht gelten. In der Regel sollten Sie den Wert auf 0 (null) festlegen. Der Prioritätswert ist jedoch nützlich, wenn Sie zwei oder mehr Symbolüberlagerungshandler implementiert haben, die Symbolüberlagerungssymbole für dasselbe Objekt anfordern können. Indem Sie die Prioritätswerte entsprechend festlegen, können Sie angeben, welche der angeforderten Symbolüberlagerungen angezeigt wird.

Anforderungen

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