PrivateExtractIconsA 함수(winuser.h)

아티클
03/15/2023

[이 함수는 일반적인 용도로 사용되지 않습니다. 이후 버전의 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

phicon 매개 변수가 NULL이고 이 함수가 성공하면 반환 값은 파일의 아이콘 수입니다. 함수가 실패하면 반환 값은 0입니다.

phicon 매개 변수가 NULL이 아니고 함수가 성공하면 반환 값은 추출된 아이콘의 수입니다. 그렇지 않으면 파일을 찾을 수 없는 경우 반환 값이 0xFFFFFFFF.

설명

이 함수는 실행 파일(.exe), DLL(.dll), 아이콘(.ico), 커서(.cur), 애니메이션 커서(.ani) 및 비트맵(.bmp) 파일에서 추출합니다. Windows 3.x 16비트 실행 파일(.exe 또는 .dll)에서 추출도 지원됩니다.

cxIcon 및 cyIcon 매개 변수는 추출할 아이콘의 크기를 지정합니다. 매개 변수의 LOWORD에 첫 번째 크기를, 두 번째 크기를 HIWORD에 배치하여 두 가지 크기를 추출할 수 있습니다. 예를 들어 MAKELONG(24, 48) cxIcon 및 cyIcon 매개 변수 모두에 대해 24 및 48 크기 아이콘을 모두 추출합니다.

DestroyIcon 함수를 호출하여 PrivateExtractIcons에서 추출한 모든 아이콘을 삭제해야 합니다.

이 함수는 Windows XP SP1(서비스 팩 1) 및 Windows Server 2003까지 SDK 헤더 및 라이브러리에 포함되지 않았습니다. 이 함수에 대한 헤더 파일 및 가져오기 라이브러리가 없는 경우 LoadLibrary 및 GetProcAddress를 사용하여 함수를 호출할 수 있습니다.

참고

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에 도입됨)