System.SysReallocMem

Aus RAD Studio API Documentation
Wechseln zu: Navigation, Suche

Delphi

function SysReallocMem(P: Pointer; Size: NativeInt): Pointer;

C++

extern DELPHI_PACKAGE void * __fastcall SysReallocMem(void * P, NativeInt Size);

Eigenschaften

Typ Sichtbarkeit Quelle Unit Übergeordnet
function public
GETMEM.INC
System.hpp
System System

Beschreibung

Gibt einen Zeiger auf eine bestimmte Anzahl von Bytes unter Beibehaltung der von Pointer angegebenen Werte zurück.

Verwenden Sie SysReallocMem beim Implementieren einer eigenen Speicherverwaltung, um die Größe eines dynamischen Speicherblocks zu ändern. Kann SysReallocMem den Speicherblock nicht vergrößern, auf den P zeigt, wird dieser freigegeben, und die betreffenden Werte werden in den zurückgegebenen neuen Speicherbereich kopiert. Ist Size kleiner als der in P angegebene Block, werden nur die ersten Size-Bytes kopiert. Andernfalls wird der gesamte Speicherbereich in den neuen Block kopiert.

Anmerkung:  Unter Windows stellt die Unit System eine begrenzte Implementierung von SysReallocMem bereit. Wenn der benutzerdefinierte Speichermanager Referenzzähler und Objekte unterstützen muss, die von Prozessen gemeinsam genutzt werden können, verwenden Sie die Implementierung von SysReallocMem aus der Unit ShareMem. ShareMem muss die erste in die Projektdatei einbezogene Unit sein, um eine konsistente Speicherverwaltung zu gewährleisten.

Warnung:  Dies ist eine interne Funktion und sollte von einer Anwendung nicht direkt aufgerufen werden. Verwenden Sie stattdessen die Funktion ReallocMem.

Siehe auch