다음을 통해 공유


HeapDestroy 함수(heapapi.h)

지정된 힙 개체를 삭제합니다.

HeapDestroy 는 프라이빗 힙 개체의 모든 페이지를 커밋 해제하고 해제하고 핸들을 힙에 무효화합니다.

구문

BOOL HeapDestroy(
  [in] HANDLE hHeap
);

매개 변수

[in] hHeap

제거될 힙에 대한 핸들입니다. 이 핸들은 HeapCreate 함수에서 반환됩니다. GetProcessHeap 함수에서 반환된 프로세스 힙에 핸들을 사용하지 마세요.

반환 값

함수가 성공하면 반환 값이 0이 아닙니다.

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

설명

프로세스는 HeapFree 함수를 먼저 호출하지 않고 HeapDestroy를 호출하여 힙에서 할당된 메모리를 해제할 수 있습니다.

예제

힙 열거

요구 사항

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

참고 항목

힙 함수

HeapCreate

메모리 관리 함수

VBS Enclave에서 사용할 수 있는 Vertdll API