LookupIconIdFromDirectory 함수(winuser.h)

아티클
05/25/2023

아이콘(RT_GROUP_ICON) 또는 커서(RT_GROUP_CURSOR) 리소스 데이터를 검색하여 현재 디스플레이 디바이스에 가장 적합한 아이콘 또는 커서를 검색합니다.

원하는 높이 또는 너비를 지정하려면 LookupIconIdFromDirectoryEx 함수를 사용합니다. 이 함수는 cxDesired cyDesired매개 변수에 0을/ 전달하여 호출합니다.

구문

int LookupIconIdFromDirectory(
  [in] PBYTE presbits,
  [in] BOOL  fIcon
);

매개 변수

[in] presbits

형식: PBYTE

아이콘 또는 커서 디렉터리 데이터입니다. 이 함수는 리소스 데이터의 유효성을 검사하지 않으므로 일반 보호(GP) 오류가 발생하거나 프리비트가 유효한 리소스 데이터를 가리키지 않는 경우 정의되지 않은 값을 반환합니다.

[in] fIcon

형식: BOOL

아이콘 또는 커서를 찾는지 여부를 나타냅니다. 이 매개 변수가 TRUE이면 함수는 아이콘을 검색합니다. 매개 변수가 FALSE이면 함수가 커서를 검색합니다.

반환 값

형식: int

함수가 성공하면 반환 값은 현재 디스플레이 디바이스에 가장 적합한 아이콘(RT_ICON) 또는 커서(RT_CURSOR)의 정수 리소스 식별자입니다.

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

설명

RT_GROUP_ICON 형식의 리소스 파일(RT_GROUP_CURSOR 커서를 나타낸다)에는 여러 디바이스 종속 형식의 아이콘(또는 커서) 데이터가 포함되어 있습니다. LookupIconIdFromDirectory 는 리소스 파일에서 현재 디스플레이 디바이스에 가장 적합한 아이콘(또는 커서)을 검색하고 정수 식별자를 반환합니다. FindResource 및 FindResourceEx 함수는 이 식별자와 함께 MAKEINTRESOURCE 매크로를 사용하여 모듈에서 리소스를 찾습니다.

아이콘 디렉터리가 리소스 종류 가 RT_GROUP_ICON 리소스 파일(또는 커서의 경우 RT_GROUP_CURSOR )과 로드할 특정 아이콘의 정수 리소스 이름이 있는 리소스 파일에서 로드됩니다. LookupIconIdFromDirectory 는 현재 디스플레이 디바이스에 가장 적합한 아이콘의 리소스 이름인 정수 식별자를 반환합니다.

LoadIcon, LoadCursor 및 LoadImage 함수는 이 함수를 사용하여 현재 디스플레이 디바이스에 가장 적합한 아이콘 또는 커서에 대해 지정된 리소스 데이터를 검색합니다.

요구 사항

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