ExtractIcon

ExtractIcon 함수 지정 된 실행 파일, 동적 연결 라이브러리 (DLL) 또는 아이콘 파일 아이콘 핸들을 검색.

큰 아이콘 또는 작은 아이콘 핸들의 배열을 검색 하려면 ExtractIconEx 함수.

HICON ExtractIcon ( HINSTANCE  hInst, / / 인스턴스 핸들LPCTSTRlpszExeFileName, / / 아이콘 파일의 이름UINTnIconIndex / 색인 / 추출 아이콘);
 

매개 변수

hInst
함수를 호출 하는 응용 프로그램의 인스턴스 핸들.
lpszExeFileName
실행 파일, DLL, 또는 아이콘 파일의 이름을 지정 하는 null로 끝나는 문자열에 대 한 포인터.
nIconIndex
검색 아이콘의 인덱스를 지정 합니다. 예를 들어,이 값이 0 이면이 함수는 핸들을 반환 합니다 지정된 된 파일의 첫 번째 아이콘.

이 값이 ? 1 이면 함수 지정한 파일에서 아이콘의 총 수를 반환 합니다. 파일 실행 파일 또는 DLL 이면 반환 값은 RT_GROUP_ICON 자원 수 있습니다. 이 파일은 한.ICO 파일을 반환 하는 값은 1.

Windows 95, Windows NT 4.0 및 이후: 이 값이-1이 아닌 음수 이면 함수는 누구의 리소스 식별자 nIconIndex의 절대 값은 지정된 된 파일의 아이콘에는 핸들을 반환 합니다. 예를 들어, 추출 아이콘의 리소스 식별자가 3-3을 사용 합니다. 아이콘의 리소스 식별자는 1를 추출 하려면 ExtractIconEx 함수를 사용.

반환 값

반환 값에는 아이콘 핸들입니다. 지정한 파일 실행 파일, DLL, 또는 아이콘 파일 아니었다, 반환은 1입니다. 아이콘이 파일에서 발견 된 경우 반환 값은 NULL.

주의

ExtractIcon DestroyIcon 함수를 호출 하 여 반환 하는 아이콘 핸들을 파괴 해야 한다.

QuickInfo

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

참고 항목

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

 

Index