Funzione GetProcessHeap (heapapi.h)

Recupera un handle nell'heap predefinito del processo chiamante. Questo handle può quindi essere usato nelle chiamate successive alle funzioni dell'heap.

Sintassi

HANDLE GetProcessHeap();

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un handle per l'heap del processo chiamante.

Se la funzione ha esito negativo, il valore restituito è NULL. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

La funzione GetProcessHeap ottiene un handle per l'heap predefinito per il processo chiamante. Un processo può usare questo handle per allocare memoria dall'heap del processo senza dover prima creare un heap privato usando la funzione HeapCreate .

Windows Server 2003 e Windows XP: Per abilitare l'heap a bassa frammentazione per l'heap predefinito del processo, chiamare la funzione HeapSetInformation con l'handle restituito da GetProcessHeap.

Esempio

Per un esempio, vedere Getting Process Heaps .For an example, see Getting Process Heaps.

Requisiti

   
Client minimo supportato Windows XP [app desktop | App UWP]
Server minimo supportato Windows Server 2003 [app desktop | App UWP]
Piattaforma di destinazione Windows
Intestazione heapapi.h (include Windows.h)
Libreria Kernel32.lib
DLL Kernel32.dll

Vedere anche

Funzioni heap

HeapCreate

Funzioni di gestione della memoria

API Vertdll disponibili nelle enclave VBS