ENUMRESNAMEPROCA 콜백 함수(libloaderapi.h)

아티클
08/24/2023

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

구문

ENUMRESNAMEPROCA Enumresnameproca;

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

매개 변수

[in, optional] hModule

형식: HMODULE

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

lpType

형식: LPCTSTR

이름이 열거되는 리소스의 형식입니다. 또는 포인터가 아닌 이 매개 변수는 MAKEINTRESOURCE(ID)일 수 있습니다. 여기서 ID는 미리 정의된 리소스 형식을 나타내는 정수 값입니다. 표준 리소스 종류는 리소스 종류를 참조하세요. 자세한 내용은 아래의 설명 섹션을 참조하세요.

lpName

형식: LPTSTR

열거 중인 형식의 리소스 이름입니다. 또는 포인터 대신 이 매개 변수는 MAKEINTRESOURCE(ID)일 수 있습니다. 여기서 ID는 리소스의 정수 식별자입니다. 자세한 내용은 아래의 설명 섹션을 참조하세요.

[in] lParam

형식: LONG_PTR

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

반환 값

형식: BOOL

열거를 계속하려면 TRUE 를 반환하고, 열거를 중지하려면 FALSE 를 반환합니다.

설명

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

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

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

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

참고

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

요구 사항


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