ExtractIconEx

ExtractIconEx 함수는 지정 된 실행 파일, 동적 연결 라이브러리 (DLL) 또는 아이콘 파일에서 추출 하는 크고 작은 아이콘 핸들의 배열의 만듭니다.

UINT ExtractIconEx (  LPCTSTR  lpszFile, int  nIconIndex, HICON까지  * phiconLarge, HICON까지  * phiconSmall, UINT  nIcons);
 

매개 변수

lpszFile

실행 파일, DLL, 또는 추출 아이콘이 들어 있는 아이콘 파일의 이름을 지정 하는 null로 끝나는 문자열에 대 한 포인터.

nIconIndex

추출할 첫 번째 아이콘의 인덱스를 지정 합니다. 예를 들어,이 값이 0 이면 지정된 된 파일의 첫 번째 아이콘 함수 추출.

이 값은-1로 하는 경우 phIconLarge 및 phiconSmall 는 모두 NULL 함수 지정한 파일에서 아이콘의 총 수를 반환 합니다. 파일 실행 파일 또는 DLL 이면 반환 값은 RT_GROUP_ICON 자원 수 있습니다. 이 파일은 한.ICO 파일을 반환 하는 값은 1.

Windows 95, Windows NT 4.0 및 이후: 이 값은 음수를 입력 하는 경우 phIconLarge 또는 phiconSmall 가 NULL 함수는 아이콘의 리소스 식별자는 nIconIndex의 절대 값을 추출 하 여 시작 합니다. 예를 들어,-3를 사용 하 여 아이콘의 리소스 식별자가 3 추출.

phiconLarge

아이콘의 배열 포인터는 수신 파일에서 추출 하는 큰 아이콘 핸들을 처리 합니다. 이 매개 변수가 NULL 인 경우 큰 아이콘이 파일에서 추출.

phiconSmall

아이콘의 배열 포인터는 수신 파일에서 추출 된 작은 아이콘 핸들을 처리 합니다. 아니 작은 아이콘 파일에서 추출이 매개 변수가 NULL 인 경우.

nIcons

파일에서 추출 하는 아이콘을 지정.

반환 값

NIconIndex 매개 변수는-1, phiconLarge 매개 변수는 NULL 및 phiconSmall 매개 변수는 NULL 일 경우 반환 값은 지정된 된 파일에 포함 된 아이콘의 숫자. 그렇지 않으면, 반환 값은 파일에서 성공적으로 추출 된 아이콘 개수.

주의

DestroyIcon 함수를 호출 하 여 ExtractIconEx 에 의해 추출 된 모든 아이콘을 파괴 해야 한다.

크고 작은 아이콘의 크기를 검색 하려면 해당 SM_CXICON, SM_CYICON, SM_CXSMICON, 및 SM_CYSMICON 플래그와 함께 GetSystemMetrics 함수.

Windows CE: NIconIndex 매개 변수 해야 0 또는-N 여기서 N은 지정 된 리소스 식별자입니다. NIcons 매개 변수는 1 이어야 합니다.

QuickInfo

nbsp;?Windows &NT: 버전 3.5 이상이 필요 합니다.
Windows:Windows 95 이상이 필요합니다.
Windows CE:버전 1.0 이상이 필요합니다.
헤더:Shellapi.h에 선언 합니다.
가져오기 라이브러리:Shell32.lib를 사용 합니다.
유니코드:Windows NT에서 유니코드와 ANSI 버전으로 구현.

참고 항목

개요 아이콘 아이콘 함수 DestroyIcon, ExtractIcon

Index