ExtractIconEx(A)

ExtractIconEx(A)

지정된 실행 가능 파일, 동적 링크 라이브러리(DLL), 또는 아이콘 파일로부터, 그 파일이 가지는 큰 아이콘 또는 작은 아이콘의 핸들을 취득해, 배열 변수에 격납합니다.

UINT ExtractIconExA(
    PCTSTR  pszFile,     // 파일명
    UINT    nIconIndex,  // 아이콘의 인덱스
    HICON  *phIconLarge, // 큰 아이콘의 핸들을 격납하는 변수
    HICON  *phIconSmall, // 작은 아이콘의 핸들을 격납하는 변수
    UINT    nIcons       // 취득하는 아이콘의 수
);

SHELL32.DLL

인수

pszFile

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

nIconIndex

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

이 파라미터에 -1 (을)를 지정해, phIconLarge 파라미터 및 phIconSmall 파라미터에 함께 0 (NULL) (을)를 지정하면, 반환값으로서 지정된 파일이 가지고 있는 아이콘의 총수가 돌아갑니다.지정된 파일이 실행 가능 파일 또는 DLL 의 경우는, RT_GROUP_ICON 자원의 수가 돌아갑니다.지정된 파일이 .ICO 파일의 경우는, 1 하지만 돌아갑니다.

이 파라미터에 부의 수를 지정해, phIconLarge 파라미터 혹은 phIconSmall 파라미터의 적어도 한편에 유효한 변수의 주소를 지정했을 경우는, 자원 ID 하지만 이 파라미터의 절대치인 아이콘이 취득됩니다.예를 들면, -3 (을)를 지정했을 경우는, 자원 ID 하지만 3 인 아이콘이 취득됩니다.

phIconLarge

큰 아이콘의 핸들을 격납하는 배열 변수의 주소를 지정합니다.큰 아이콘이 필요없는 경우에는 0 (NULL) (을)를 지정합니다.

phIconSmall

작은 아이콘의 핸들을 격납하는 배열 변수의 주소를 지정합니다.작은 아이콘이 필요없는 경우에는 0 (NULL) (을)를 지정합니다.

nIcons

꺼내는 아이콘의 수를 지정합니다.

반환값

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

그 이외의 경우는, 취득한 아이콘의 수가 돌아갑니다.

해설

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

대응 정보

Windows 95 이후 / Windows NT 4.0 이후