PrivateExtractIconsA 함수(winuser.h)
[이 함수는 일반적인 용도로 사용되지 않습니다. 이후 버전의 Windows에서는 변경되거나 사용할 수 없습니다.]
지정된 파일에서 추출된 아이콘에 대한 핸들 배열을 만듭니다.
통사론
UINT PrivateExtractIconsA(
[in] LPCSTR szFileName,
[in] int nIconIndex,
[in] int cxIcon,
[in] int cyIcon,
[out, optional] HICON *phicon,
[out, optional] UINT *piconid,
[in] UINT nIcons,
[in] UINT flags
);
매개 변수
[in] szFileName
형식: LPCTSTR
아이콘을 추출할 파일의 경로와 이름입니다.
[in] nIconIndex
형식: int
추출할 첫 번째 아이콘의 인덱스(0부터 시작)입니다. 예를 들어 이 값이 0이면 함수는 지정된 파일의 첫 번째 아이콘을 추출합니다.
[in] cxIcon
형식: int
원하는 가로 아이콘 크기입니다. 비고를 참조하세요.
[in] cyIcon
형식: int
원하는 세로 아이콘 크기입니다. 비고를 참조하세요.
[out, optional] phicon
형식: HICON*
반환된 아이콘 핸들 배열에 대한 포인터입니다.
[out, optional] piconid
형식: UINT*
현재 디스플레이 디바이스에 가장 적합한 아이콘의 반환된 리소스 식별자에 대한 포인터입니다. 반환된 식별자는 이 형식에 대해 식별자를 사용할 수 없는 경우 0xFFFFFFFF. 그렇지 않으면 식별자를 가져올 수 없는 경우 반환된 식별자는 0입니다.
[in] nIcons
형식: UINT
파일에서 추출할 아이콘의 수입니다. 이 매개 변수는 .exe 및 .dll 파일에서 추출할 때만 유효합니다.
[in] flags
형식: UINT
이 함수를 제어하는 플래그를 지정합니다. 이러한 플래그는 LoadImage 함수에서 사용하는 LR_* 플래그입니다.
반환 값
형식: UINT
발언
이 함수는 실행 파일(.exe), DLL(.dll), 아이콘(.ico), 커서(.cur), 애니메이션 커서(.ani) 및 비트맵(.bmp) 파일에서 추출합니다. Windows 3.x 16비트 실행 파일(.exe 또는 .dll)에서 추출도 지원됩니다.
cxIcon 및 cyIcon 매개 변수는 추출할 아이콘의 크기를 지정합니다. 매개 변수의 LOWORD에 첫 번째 크기를 배치하고 두 번째 크기를 HIWORD에 배치하여 두 가지 크기를 추출할 수 있습니다.
예를 들어 cxIcon 및 cyIcon 매개 변수 모두에 대한 MAKELONG(24, 48) 24 및 48 크기 아이콘을 모두 추출합니다.
DestroyIcon 함수를 호출하여 PrivateExtractIcons 의해 추출된 모든 아이콘을 삭제해야 합니다.
이 함수는 Windows XP SP1(서비스 팩 1) 및 Windows Server 2003까지 SDK 헤더 및 라이브러리에 포함되지 않았습니다. 이 함수에 대한 헤더 파일 및 가져오기 라이브러리가 없는 경우
메모
winuser.h 헤더는 UNICODE 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 PrivateExtractIcons를 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입대한
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 Professional [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows 2000 Server [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | winuser.h |
| 라이브러리 | User32.lib |
| DLL | User32.dll |
| API 집합 | ext-ms-win-ntuser-misc-l1-5-1(Windows 10 버전 10.0.14393에서 도입됨) |
참고 항목
개념
ExtractIcon
ExtractIconEx
참조