ENUMRESTYPEPROCA 콜백 함수(libloaderapi.h)

아티클
11/20/2024

EnumResourceTypes 및 EnumResourceTypesEx 함수와 함께 사용되는 애플리케이션 정의 콜백 함수입니다. 리소스 유형을 받습니다. ENUMRESTYPEPROC 형식은 이 콜백 함수에 대한 포인터를 정의합니다. EnumResTypeProc 애플리케이션 정의 함수 이름의 자리 표시자입니다.

통사론

ENUMRESTYPEPROCA Enumrestypeproca;

BOOL Enumrestypeproca(
  [in, optional] HMODULE hModule,
                 LPSTR lpType,
  [in]           LONG_PTR lParam
)
{...}

매개 변수

[in, optional] hModule

형식: HMODULE

형식을 열거할 리소스가 포함된 실행 파일이 있는 모듈에 대한 핸들입니다. 이 매개 변수가 NULL경우 함수는 현재 프로세스를 만드는 데 사용되는 모듈의 리소스 유형을 열거합니다.

lpType

형식: LPTSTR

형식이 열거되는 리소스의 형식입니다.

또는 포인터가 아니라 ID(MAKEINTRESOURCE)를 수 있습니다. 여기서 ID는 지정된 리소스 유형의 정수 식별자입니다. 표준 리소스 종류는 리소스 종류참조하세요. 자세한 내용은 아래 설명 섹션을 참조하세요.

[in] lParam

형식: LONG_PTR

EnumResourceTypes 또는 EnumResourceTypesEx 함수에 전달되는 애플리케이션 정의 매개 변수입니다. 이 매개 변수는 오류 검사에 사용할 수 있습니다.

반환 값

형식: BOOL

TRUE 반환하여 열거를 계속하거나 FALSE 열거를 중지합니다.

발언

IS_INTRESOURCE(lpszType)가 TRUE경우 lpszType 지정된 리소스 유형의 정수 식별자를 지정합니다. 그렇지 않으면 null로 끝나는 문자열에 대한 포인터입니다. 문자열의 첫 번째 문자가 파운드 기호(#)인 경우 나머지 문자는 리소스 형식의 정수 식별자를 지정하는 10진수를 나타냅니다. 예를 들어 문자열 "#258"은 식별자 258을 나타냅니다.

애플리케이션은 EnumResourceTypes 또는 EnumResourceTypesEx 함수에 주소를 전달하여 이 함수를 등록해야 합니다.

콜백 함수가 FALSE반환하는 경우 EnumResourceTypes 또는 EnumResourceTypesEx 열거를 중지하고 false반환합니다. Windows XP 및 이전 버전에서는 GetLastError 가져온 값이 ERROR_SUCCESS; Windows Vista부터 마지막 오류 값은 ERROR_RESOURCE_ENUM_USER_STOP.

메모

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

요구 사항

요구	값
지원되는 최소 클라이언트	Windows 2000 Professional [데스크톱 앱만 해당]
지원되는 최소 서버	Windows 2000 Server [데스크톱 앱만 해당]
대상 플랫폼	Windows
헤더	libloaderapi.h(Windows.h 포함)