CreateIconFromResource 함수(winuser.h)

아이콘을 설명하는 리소스 비트에서 아이콘 또는 커서를 만듭니다.

원하는 높이 또는 너비를 지정하려면 CreateIconFromResourceEx 함수를 사용합니다.

구문

HICON CreateIconFromResource(
  [in] PBYTE presbits,
  [in] DWORD dwResSize,
  [in] BOOL  fIcon,
  [in] DWORD dwVer
);

[in] presbits

형식: PBYTE

아이콘 또는 커서 리소스 비트를 포함하는 DWORD 정렬 버퍼 포인터입니다. 이러한 비트는 일반적으로 LookupIconIdFromDirectory, LookupIconIdFromDirectoryEx 및 LoadResource 함수에 대한 호출에 의해 로드됩니다.

아이콘 및 커서 리소스 형식에 대한 자세한 내용은 커서 및 아이콘 리소스를 참조하세요.

[in] dwResSize

형식:DWORD

presbits 매개 변수가 가리키는 비트 집합의 크기(바이트)입니다.

[in] fIcon

형식: BOOL

아이콘 또는 커서를 만들 것인지 여부를 나타냅니다. 이 매개 변수가 TRUE이면 아이콘이 만들어집니다. FALSE이면 커서를 만들어야 합니다.

LOCALHEADER 구조는 커서 핫스팟을 정의하며 커서 리소스 비트에서 읽은 첫 번째 데이터입니다.

[in] dwVer

형식:DWORD

presbits 매개 변수가 가리키는 리소스 비트에 대한 아이콘 또는 커서 형식의 버전 번호입니다. 값은 0x00020000 보다 크거나 같아야 하며 0x00030000 보다 작거나 같아야 합니다. 이 매개 변수는 일반적으로 0x00030000 설정됩니다.

형식: HICON

함수가 성공하면 반환 값은 아이콘 또는 커서에 대한 핸들입니다.

함수가 실패하면 반환 값은 NULL입니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

CreateIconFromResource, CreateIconFromResourceEx, CreateIconIndirect, GetIconInfo, LookupIconIdFromDirectory 및 LookupIconIdFromDirectoryEx 함수를 사용하면 셸 애플리케이션 및 아이콘 브라우저가 시스템 전체에서 리소스를 검사하고 사용할 수 있습니다.

CreateIconFromResource 함수는 CreateIconFromResourceEx를 호출하여 플래그로 전달 LR_DEFAULTSIZE|LR_SHARED 합니다.

CreateIconFromResource를 사용하여 만든 커서의 경우 아이콘에 DestroyIcon 또는 DestroyCursor를 호출해야 합니다.

요구 사항	값
지원되는 최소 클라이언트	Windows 2000 Professional[데스크톱 앱만]
지원되는 최소 서버	Windows 2000 Server[데스크톱 앱만]
대상 플랫폼	Windows
헤더	winuser.h(Windows.h 포함)
라이브러리	User32.lib
DLL	User32.dll