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

아이콘 오버레이 비트맵의 위치를 제공합니다.

구문

HRESULT GetOverlayInfo(
  [out] LPWSTR pwszIconFile,
        int    cchMax,
  [out] int    *pIndex,
  [out] DWORD  *pdwFlags
);

매개 변수

[out] pwszIconFile

형식: PWSTR

아이콘이 포함된 파일의 정규화된 경로를 포함하는 null로 끝나는 유니코드 문자열입니다. .dll, .exe 및 .ico 파일 형식은 모두 허용됩니다. 파일 이름을 반환하는 경우 pdwFlags에서 ISIOI_ICONFILE 플래그를 설정해야 합니다.

cchMax

형식: int

pwszIconFile 버퍼의 크기(유니코드 문자)입니다.

[out] pIndex

형식: int*

여러 아이콘이 포함된 파일의 아이콘을 식별하는 데 사용되는 인덱스 값에 대한 포인터입니다. 인덱스를 반환하는 경우 pdwFlags에서 ISIOI_ICONINDEX 플래그를 설정해야 합니다.

[out] pdwFlags

형식: DWORD*

메서드에서 반환되는 정보를 지정하는 비트맵에 대한 포인터입니다. 이 매개 변수는 다음 값 중 하나 또는 둘 다일 수 있습니다.

ISIOI_ICONFILE(0x00000001)

아이콘 파일의 경로는 pwszIconFile을 통해 반환됩니다.

ISIOI_ICONINDEX(0x00000002)

pwszIconFile에는 둘 이상의 아이콘이 있습니다. 아이콘의 인덱스는 pIndex를 통해 반환됩니다.

반환 값

형식: HRESULT

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

설명

이 메서드는 시작 시 Shell에서 호출되므로 처리기의 아이콘 오버레이를 시스템 이미지 목록에 추가할 수 있습니다. 초기화가 완료되면 셸은 처리기의 아이콘 오버레이를 표시해야 할 때 GetOverlayInfo 를 호출합니다.

요구 사항