IShellIconOverlayIdentifier::GetPriority 메서드(shobjidl_core.h)

아이콘 오버레이의 우선 순위를 지정합니다.

구문

HRESULT GetPriority(
  [out] int *pPriority
);

매개 변수

[out] pPriority

형식: int*

오버레이 식별자의 우선 순위를 나타내는 값의 주소입니다. 가능한 값의 범위는 0에서 100까지이며 우선 순위는 0입니다.

반환 값

형식: HRESULT

성공하면 S_OK 반환하고, 그렇지 않으면 COM 오류 코드를 반환합니다.

설명

개체에 둘 이상의 아이콘 오버레이를 사용할 수 있는 경우 우선 순위가 가장 높은 아이콘 오버레이가 선택됩니다. 셸에는 많은 경우에 우선 순위를 결정하는 내부 규칙 집합이 있습니다. GetPriority에서 반환되는 값은 셸의 내부 규칙이 적용되지 않는 경우에 사용됩니다. 일반적으로 값을 0으로 설정해야 합니다. 그러나 우선 순위 값은 동일한 개체에 대한 아이콘 오버레이 아이콘을 요청할 수 있는 두 개 이상의 아이콘 오버레이 처리기를 구현한 경우에 유용합니다. 우선 순위 값을 적절하게 설정하여 요청된 아이콘 오버레이 중 표시할 아이콘 오버레이를 지정할 수 있습니다.

요구 사항

지원되는 최소 클라이언트	Windows 2000 Professional, Windows XP [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2003 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	shobjidl_core.h(Shlobj.h 포함)
DLL	Shell32.dll(버전 5.0 이상)

추가 정보

IShellIconOverlayIdentifier