IShellIconOverlayIdentifier::GetPriority method (shobjidl_core.h)

Specifies the priority of an icon overlay.

Syntax

HRESULT GetPriority(
  [out] int *pPriority
);

Parameters

[out] pPriority

Type: int*

The address of a value that indicates the priority of the overlay identifier. Possible values range from zero to 100, with zero the highest priority.

Return value

Type: HRESULT

Returns S_OK if successful, or a COM error code otherwise.

Remarks

If more than one icon overlay is available for an object, the one with highest priority is chosen. The Shell has a set of internal rules that determine priority for many cases. The value returned by GetPriority is used for those cases in which the Shell's internal rules do not apply. Typically, you should set the value to zero. However, the priority value is useful when you have implemented two or more icon overlay handlers that can request icon overlay icons for the same object. By setting the priority values appropriately, you can specify which of the requested icon overlays will be displayed.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional, Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header shobjidl_core.h (include Shlobj.h)
DLL Shell32.dll (version 5.0 or later)

See also

IShellIconOverlayIdentifier