FreeResource 함수(libloaderapi.h)

아티클
03/02/2024

참고

이 함수는 사용되지 않으며 16비트 Windows와의 이전 버전과의 호환성에서만 지원됩니다. 32비트 Windows 애플리케이션의 경우 LoadResource를 사용하여 로드된 리소스를 해제할 필요가 없습니다. 최신 버전의 Windows의 경우 이 함수는 항상 FALSE를 반환합니다.

로드된 리소스의 참조 수를 1씩 줄입니다. 참조 수가 0에 도달하면 리소스가 차지하는 메모리가 해제됩니다.

구문

BOOL FreeResource(
  [in] HGLOBAL hResData
);

매개 변수

[in] hResData

형식: HGLOBAL

리소스의 핸들입니다. hglbResource가 LoadResource에 의해 만들어진 것으로 가정합니다.

반환 값

형식: BOOL

함수가 성공할 경우 반환 값은 0입니다.

함수가 실패하면 반환 값은 0이 아닌 값으로, 리소스가 해제되지 않았다는 것을 나타냅니다.

설명

다른 함수로 로드된 리소스의 경우 FreeResource 가 다음 함수로 대체되었습니다.

리소스 유형	FreeResource 교체
액셀러레이터	DestroyAcceleratorTable
Bitmap	DeleteObject
커서	DestroyCursor
아이콘	DestroyIcon
메뉴	DestroyMenu

리소스에 대한 참조 수는 애플리케이션이 리소스에 대한 LoadResource 함수를 호출할 때마다 증가(1씩 증가)됩니다.

생성한 프로세스가 종료되면 시스템에서 이러한 리소스를 자동으로 삭제합니다. 그러나 적절한 함수를 호출하면 메모리가 절약됩니다. 자세한 내용은 LoadResource를 참조하세요.

요구 사항

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