GetProcessHeap 함수(heapapi.h)

호출 프로세스의 기본 힙에 대한 핸들을 검색합니다. 그런 다음 이 핸들은 힙 함수에 대한 후속 호출에서 사용할 수 있습니다.

구문

HANDLE GetProcessHeap();

반환 값

함수가 성공하면 반환 값은 호출 프로세스의 힙에 대한 핸들입니다.

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

설명

GetProcessHeap 함수는 호출 프로세스에 대한 기본 힙에 대한 핸들을 가져옵니다. 프로세스는 먼저 HeapCreate 함수를 사용하여 프라이빗 힙을 만들지 않고도 이 핸들을 사용하여 프로세스 힙에서 메모리를 할당할 수 있습니다.

Windows Server 2003 및 Windows XP: 프로세스의 기본 힙에 대해 하위 조각화 힙을 사용하도록 설정하려면 GetProcessHeap에서 반환된 핸들을 사용하여 HeapSetInformation 함수를 호출합니다.

예제

예제는 프로세스 힙 가져오기를 참조하세요.

요구 사항

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

참고 항목

힙 함수

HeapCreate

메모리 관리 함수

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