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) |