FindResourceA 함수(winbase.h)

아티클
08/27/2023

지정된 모듈에서 지정된 형식과 이름을 가진 리소스의 위치를 결정합니다.

언어를 지정하려면 FindResourceEx 함수를 사용합니다.

구문

HRSRC FindResourceA(
  [in, optional] HMODULE hModule,
  [in]           LPCSTR  lpName,
  [in]           LPCSTR  lpType
);

매개 변수

[in, optional] hModule

형식: HMODULE

이식 가능한 실행 파일 또는 함께 제공되는 MUI 파일에 리소스가 포함된 모듈에 대한 핸들입니다. 이 매개 변수가 NULL인 경우 함수는 현재 프로세스를 만드는 데 사용되는 모듈을 검색합니다.

[in] lpName

형식: LPCTSTR

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

[in] lpType

형식: LPCTSTR

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

반환 값

형식: HRSRC

함수가 성공하면 반환 값은 지정된 리소스의 정보 블록에 대한 핸들입니다. 리소스에 대한 핸들을 가져오려면 이 핸들을 LoadResource 함수에 전달합니다.

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

설명

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

리소스에 필요한 메모리 양을 줄이려면 애플리케이션이 이름 대신 정수 식별자를 사용하여 참조해야 합니다.

애플리케이션은 FindResource 를 사용하여 모든 유형의 리소스를 찾을 수 있지만, 이 함수는 애플리케이션이 LoadResource 에 대한 후속 호출을 수행한 다음 LockResource를 호출하여 이진 리소스 데이터에 액세스해야 하는 경우에만 사용해야 합니다.

리소스를 즉시 사용하려면 애플리케이션에서 다음 리소스별 함수 중 하나를 사용하여 리소스를 찾고 데이터를 더 사용 가능한 형식으로 변환해야 합니다.

함수	작업
FormatMessage	메시지 테이블 항목을 로드하고 서식을 지정합니다.
LoadAccelerators	가속기 테이블을 로드합니다.
LoadBitmap	비트맵 리소스를 로드합니다.
LoadCursor	커서 리소스를 로드합니다.
LoadIcon	아이콘 리소스를 로드합니다.
LoadMenu	메뉴 리소스를 로드합니다.
LoadString	문자열 테이블 항목을 로드합니다.

예를 들어 애플리케이션은 LoadIcon 함수를 사용하여 화면에 표시할 아이콘을 로드할 수 있습니다. 그러나 애플리케이션은 아이콘을 로드하는 경우 FindResource 및 LoadResource 를 사용하여 데이터를 다른 애플리케이션에 복사해야 합니다.

문자열 리소스는 섹션당 최대 16개의 문자열로 구성된 섹션에 저장됩니다. 각 섹션의 문자열은 계산된(반드시 null로 끝나는 것은 아님) 유니코드 문자열의 시퀀스로 저장됩니다. LoadString 함수는 해당 섹션에서 문자열 리소스를 추출합니다.

예제

예제는 리소스 업데이트를 참조하세요.

요구 사항

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