지정된 파일에서 추출된 아이콘에 대한 핸들 배열을 만듭니다.
참고 항목
이 함수는 Windows XP SP2(서비스 팩 2)를 통해 사용할 수 있습니다. 후속 버전에서 변경되거나 사용하지 못할 수 있습니다. 대신 SHDefExtractIcon 함수를 사용합니다.
구문
UINT SHExtractIconsW(
_In_ LPCWSTR pszFileName,
_In_ int nIconIndex,
_In_ int cxIcon,
_In_ int cyIcon,
_Out_ HICON *phIcon,
_Out_ UINT *pIconId,
_In_ UINT nIcons,
_In_ UINT flags
);
매개 변수
-
pszFileName [in]
-
형식: LPCWSTR
아이콘을 추출할 파일 이름에 대한 포인터입니다.
-
nIconIndex [in]
-
형식: int
pszFileName에 명명된 리소스에서 추출할 첫 번째 아이콘의 인덱스입니다.
-
cxIcon [in]
-
형식: int
아이콘의 원하는 너비입니다. 설명 부분을 참조하세요.
-
cyIcon [in]
-
형식: int
아이콘의 원하는 높이입니다. 설명 부분을 참조하세요.
-
phIcon [out]
-
형식: HICON*
이 함수가 반환되면 아이콘 핸들 배열에 대한 포인터가 포함됩니다.
-
pIconId [out]
-
형식: UINT*
이 함수가 반환될 때 현재 디스플레이 디바이스에 가장 적합한 추출된 아이콘의 리소스 식별자에 대한 포인터를 포함합니다. 이 형식에 사용할 수 있는 식별자가 없으면 0xFFFFFFFF 포함합니다. 다른 이유로 식별자를 가져올 수 없는 경우 0을 반환합니다.
-
nIcons [in]
-
형식: UINT
pszFileName에 명명된 리소스에서 추출할 아이콘의 수입니다. 이 매개 변수는 리소스가 .exe 또는 .dll 파일인 경우에만 유효합니다.
-
플래그 [in]
-
형식: UINT
이 함수를 제어하는 플래그입니다. 가능한 값은 LoadImage 함수의 fuLoad 매개 변수를 참조하세요.
반환 값
형식: UINT
성공하면 0이 아닌 값입니다. 그렇지 않으면 0입니다.
설명
SHExtractIconsW 는 다음 파일 형식에서 추출합니다.
- 실행 파일(.exe)
- DLL(.dll)
- 아이콘(.ico)
- 커서(.cur)
- 애니메이션 커서(.ani)
- 비트맵(.bmp)
Windows 3에서 추출합니다.x 16비트 실행 파일(.exe 또는 .dll)도 지원됩니다.
cxIcon 및 cyIcon 매개 변수는 추출할 아이콘의 크기를 지정합니다. LOWORD와 HIWORD 간에 값을 분할하여 각 매개 변수를 통해 두 가지 크기를 추출할 수 있습니다. 매개 변수의 LOWORD에 원하는 첫 번째 크기를, 두 번째 크기를 HIWORD에 넣습니다. 예를 들어 cxIcon 및 cyIcon 모두에 대한 MAKELONG(24, 48)은 24 및 48 크기의 아이콘을 모두 추출합니다.
호출 프로세스는 DestroyIcon 함수를 호출하여 이 함수를 통해 추출된 모든 아이콘을 삭제합니다.
SHExtractIconsW 는 이름으로 내보내거나 공용 헤더 파일에 선언되지 않습니다. 이를 사용하려면 일치하는 프로토타입을 선언하고 GetProcAddress를 사용하여 이 함수를 호출하는 데 사용할 수 있는 Shell32.dll의 함수 포인터를 요청해야 합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 |
Windows 2000 Professional, Windows XP [데스크톱 앱만 해당] |
| 지원되는 최소 서버 |
Windows Server 2003 [데스크톱 앱만 해당] |
| DLL |
|
| 유니코드 및 ANSI 이름 |
SHExtractIconsW (유니코드) |