_recalloc_dbg
Ordnet ein Array neu zu und initialisiert seine Elemente auf 0 (nur Debugversion).
void *_recalloc_dbg( void *userData, size_t num, size_t size, int blockType, const char *filename, int linenumber );
Parameter
userData
Zeiger zum vorherigen belegten Speicherblock.num
Angeforderte Anzahl von Speicherblöcken.size
Angeforderte Größe eines Speicherblocks (Bytes).blockType
Angeforderter Typ des Speicherblocks: _CLIENT_BLOCK oder _NORMAL_BLOCK.Informationen zu den Zuordnungsblocktypen und deren Verwendung finden Sie unter Blocktypen auf dem Debugheap.
filename
Zeiger zum Namen der Quelldatei, der die Zuordnung angefordert hat, oder NULL.linenumber
Zeilennummer in der Quelldatei, in der die Zuordnung angefordert wurde, oder NULL.
Die filename- und linenumber-Parameter sind nur verfügbar, wenn _recalloc_dbg explizit aufgerufen wurde oder die _CRTDBG_MAP_ALLOC-Präprozessorkonstante definiert wurde.
Rückgabewert
Bei erfolgreichem Abschluss gibt diese Funktion entweder einen Zeiger an den Benutzerteil des neu belegten Speicherblocks zurück, ruft die neue Handlerfunktion auf oder gibt NULL zurück. Eine vollständige Beschreibung des Rückgabeverhaltens finden Sie im folgenden Abschnitt "Hinweise". Weitere Informationen zur Verwendung der neuen Handlerfunktion finden Sie unter der _recalloc-Funktion.
Hinweise
_recalloc_dbg ist eine Debugversion der _recalloc-Funktion. Wenn _DEBUG nicht definiert ist, wird jeder Aufruf von _recalloc_dbg zu einem Aufruf von _recalloc reduziert. Sowohl _recalloc als auch _recalloc_dbg belegen einen Speicherblock im Basisheap neu, jedoch verfügt _recalloc_dbg über mehrere Debugfunktionen: Puffer auf beiden Seiten des Benutzerteils des Blocks zum Prüfen auf Speicherverluste, einen Blocktypparameter zum Nachverfolgen von bestimmten Belegungstypen und filename/linenumber-Informationen zum Ermitteln des Ursprungs von Belegungsanforderungen.
_recalloc_dbg ordnet den angegebenen Speicherblock mit etwas mehr Speicherplatz als die erforderliche Größe (num * size) neu zu, die größer oder kleiner als die Größe des ursprünglich zugeordneten Speicherblocks sein kann. Der zusätzliche Speicherplatz wird vom Debugheapmanager verwendet, um die Debugspeicherblöck zu verknüpfen und Debugheaderinformationen und Überschreibungspuffer für die Anwendung bereitzustellen. Durch die Neubelegung wird der ursprüngliche Speicherblock möglicherweise an einen anderen Speicherort im Heap verschoben und auch die Größe des Speicherblocks geändert. Der Benutzerteil des Blocks wird mit dem Wert 0xCD gefüllt, und jeder der Überschreibungspuffer wird mit 0xFD gefüllt.
_recalloc_dbg legt errno auf ENOMEM fest, wenn eine Speicherbelegung fehlschlägt. EINVAL wird zurückgegeben, wenn der benötigte Speicherplatz (einschließlich des bereits erwähnten Mehraufwands) _HEAP_MAXREQ überschreitet. Informationen zu diesem und anderen Fehlercodes finden Sie unter errno, _doserrno, _sys_errlist und _sys_nerr.
Informationen darüber, wie Speicherblöcke in der Debugversion des Basisheaps zugeordnet, initialisiert und verwaltet werden, finden Sie unter Details zum CRT-Debugheap. Weitere Informationen zu den Unterschieden zwischen dem Aufruf einer Standardheapfunktion und der Debugversion in einem Debugbuild einer Anwendung finden Sie unter Debugversionen von Heapreservierungsfunktionen.
Anforderungen
Routine |
Erforderlicher Header |
|---|---|
_recalloc_dbg |
<crtdbg.h> |
Weitere Informationen zur Kompatibilität finden Sie unter Kompatibilität in der Einführung.
Bibliotheken
Nur Debugversionen von C-Laufzeitbibliotheken.
.NET Framework-Entsprechung
Nicht zutreffend. Mit PInvoke rufen Sie die Standard-C-Funktion auf. Weitere Informationen finden Sie unter Beispiele für Plattformaufrufe.