IAssocHandler::GetIconLocation 메서드(shobjidl_core.h)

애플리케이션과 연결된 아이콘의 위치를 검색합니다.

구문

HRESULT GetIconLocation(
  [out] LPWSTR *ppszPath,
  [out] int    *pIndex
);

매개 변수

[out] ppszPath

형식: LPWSTR*

이 메서드가 반환될 때 에는 애플리케이션 아이콘에 대한 경로가 포함된 null로 끝나는 유니코드 문자열에 대한 포인터의 주소가 포함됩니다.

[out] pIndex

형식: int*

이 메서드가 반환되면 ppszPath에서 라는 리소스 내에 있는 아이콘의 인덱스에 대한 포인터를 포함합니다.

반환 값

형식: HRESULT

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

아이콘을 찾을 수 없는 경우 함수는 실행 파일의 경로와 아이콘 인덱스(0)를 반환합니다.

성능상의 이유로 애플리케이션은 반환된 경로에서 직접 아이콘을 로드하는 대신 셸 이미지 캐시를 사용하여 아이콘을 검색할 수 있습니다. 경로 및 아이콘 인덱스가 Shell_GetCachedImageIndex 직접 전달될 수 있습니다. 이 것의 한 가지 이점은 셸 캐시가 애플리케이션에 사용할 수 있는 아이콘이 없는 경우 기본 아이콘을 제공할 수 있다는 것입니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows Vista [데스크톱 앱만 해당]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	shobjidl_core.h(Shobjidl.h 포함)