ExtractIcon(A)

ExtractIcon(A)

지정된 실행 가능 파일, 동적 링크 라이브러리(DLL), 또는 아이콘 파일로부터, 그 파일이 가지는 아이콘의 핸들을 취득합니다.

HICON ExtractIconA(
    HINSTANCE hInst,       // 인스턴스
    PCTSTR    pszFileName, // 파일명
    UINT      nIconIndex   // 아이콘 인덱스
);

SHELL32.DLL

인수

hInst

호출측 어플리케이션의 인스턴스 핸들을 지정합니다.

pszFileName

파일명을 나타내는 문자열의 주소를 지정합니다.실행 가능 파일, DLL , 아이콘 파일의 몇개의 파일명을 지정할 수 있습니다.

nIconIndex

취득하는 아이콘의 0 (으)로부터 시작되는 인젝 쿠스를 지정합니다.예를 들면, 이 파라미터에 0 (을)를 지정했을 경우는 최초의 아이콘 하지만 취득됩니다.

-1 (을)를 지정하면, 반환값으로서 지정된 파일이 가지고 있는 아이콘의 총수가 돌아갑니다.지정된 파일이 실행 가능 파일 또는 DLL 의 경우는, RT_GROUP_ICON 자원의 수가 돌아갑니다.지정된 파일이 .ICO 파일의 경우는, 1 하지만 돌아갑니다.

Windows 95 / NT4.0 이후： 이 파라미터에 -1 이외의 부의 수를 지정했을 경우는, 자원 ID 하지만 이 파라미터의 절대치인 아이콘이 취득됩니다.예를 들면, -3 (을)를 지정했을 경우는, 자원 ID 하지만 3 인 아이콘이 취득됩니다.자원 ID 하지만 1 인 아이콘을 취득하려면 ExtractIconEx 함수를 사용합니다.

반환값

함수가 성공하면, 취득된 아이콘의 핸들이 돌아갑니다.

nIconIndex 파라미터에 -1 (을)를 지정했을 경우는, 지정된 파일이 가지는 아이콘의 총수가 돌아갑니다.

지정된 파일이 실행 가능 파일, DLL , 아이콘 파일의 머지않아도 아니었던 경우에는 1 하지만 돌아갑니다.

지정된 파일내에 아이콘이 발견되지 않았던 경우에는, 0 (NULL) 하지만 돌아갑니다.

해설

아이콘이 불필요하게 되면, DestroyIcon 함수를 호출해 아이콘 핸들을 파기하지 않으면 안됩니다.

대응 정보

Windows 95 이후 / Windows NT 3.1 이후