EnumResourceTypesA 함수(winbase.h)

아티클
06/22/2023

이진 모듈 내에서 리소스 종류를 열거합니다. Windows Vista부터는 일반적으로 언어 중립적인 LN 파일( 이식 가능한 실행 파일 )이며, 열거형에는 지역화 가능한 언어 리소스가 포함된 해당 언어별 리소스 파일(.mui 파일)의 리소스도 포함됩니다. hModule을 사용하여 .mui 파일을 지정할 수도 있습니다. 이 경우 해당 파일만 리소스 유형을 검색합니다.

또는 애플리케이션에서 열거할 리소스 파일을 보다 정확하게 제어할 수 있는 EnumResourceTypesEx를 호출할 수 있습니다.

구문

BOOL EnumResourceTypesA(
  [in, optional] HMODULE          hModule,
  [in]           ENUMRESTYPEPROCA lpEnumFunc,
  [in]           LONG_PTR         lParam
);

매개 변수

[in, optional] hModule

형식: HMODULE

검색할 모듈에 대한 핸들입니다. 이 핸들은 LoadLibrary 또는 LoadLibraryEx를 통해 가져와야 합니다.

자세한 내용은 설명 부분을 참조하십시오.

이 매개 변수가 NULL인 경우 현재 프로세스를 만드는 데 사용되는 모듈에 핸들을 전달하는 것과 같습니다.

[in] lpEnumFunc

형식: ENUMRESTYPEPROC

열거된 각 리소스 종류에 대해 호출할 콜백 함수에 대한 포인터입니다. 자세한 내용은 EnumResTypeProc 함수를 참조하세요.

[in] lParam

형식: LONG_PTR

콜백 함수에 전달되는 애플리케이션 정의 값입니다.

반환 값

형식: BOOL

성공하면 TRUE를 반환하고, 그렇지 않으면 FALSE를 반환합니다. 확장 오류 정보를 가져오려면 GetLastError를 호출합니다.

설명

찾은 각 리소스 종류에 대해 EnumResourceTypes 는 애플리케이션 정의 콜백 함수 lpEnumFunc를 호출하여 찾은 각 리소스 종류와 EnumResourceTypes에 전달된 다양한 다른 매개 변수를 전달합니다.

EnumResourceTypes는 콜백 함수가 FALSE 를 반환하거나 모든 리소스 형식이 열거될 때까지 리소스 종류를 계속 열거합니다.

Windows Vista부터 hModule 이 LN 파일을 지정하는 경우 열거된 형식은 LN 파일 및 연결된 .mui 파일에 있는 리소스에 해당합니다. .mui 파일이 없으면 LN 파일의 형식만 반환됩니다. .mui 파일이 검색되는 순서는 일반적인 리소스 로더 검색 순서입니다. 자세한 내용은 사용자 인터페이스 언어 관리를 참조하세요. 적절한 .mui 파일이 하나 있으면 단일 LN 파일에 해당하는 모든 .mui 파일에 동일한 리소스 유형 집합이 있으므로 검색이 LN 파일과 연결된 다른 .mui 파일로 계속 진행되지 않습니다.

열거형에는 중복 항목이 포함되지 않습니다. 지정된 리소스 형식이 LN 파일과 .mui 파일 모두에 포함된 경우 형식은 한 번만 열거됩니다.

예제

예제는 리소스 목록 만들기를 참조하세요.

참고

winbase.h 헤더는 ENumResourceTypes를 유니코드 전처리기 상수의 정의에 따라 이 함수의 ANSI 또는 유니코드 버전을 자동으로 선택하는 별칭으로 정의합니다. 인코딩 중립 별칭을 인코딩 중립이 아닌 코드와 혼합하면 컴파일 또는 런타임 오류가 발생하는 불일치가 발생할 수 있습니다. 자세한 내용은 함수 프로토타입에 대한 규칙을 참조하세요.

요구 사항


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