_realloc_dbg
以移動及/或調整區塊大小的方式重新配置堆積中的指定記憶體區塊 (僅限偵錯版本)。
語法
void *_realloc_dbg(
void *userData,
size_t newSize,
int blockType,
const char *filename,
int linenumber
);
參數
userData
之前配置的記憶體區塊的指標。
newSize
重新配置區塊的要求大小 (位元組)。
blockType
重新配置區塊的要求類型：_CLIENT_BLOCK 或 _NORMAL_BLOCK。
filename
要求 realloc 作業或 NULL之原始程式檔名稱的指標。
linenumber
要求NULL作業的來源realloc檔案或 中的行號。
filename只有在明確呼叫 或_CRTDBG_MAP_ALLOC定義預處理器常數時_realloc_dbg，才能使用 和 linenumber 參數。
傳回值
成功完成時，此函式會傳回重新配置記憶體區塊之使用者部分的指標、呼叫新的處理程式函式，或傳 NULL回 。 如需傳回行為的完整說明，請參閱下列＜備註＞一節。 如需如何使用新處理程式函式的詳細資訊，請參閱 函式 realloc 。
備註
_realloc_dbg 是函式 realloc 的偵錯版本。 未定義 時 _DEBUG ，對的每個呼叫 _realloc_dbg 都會縮減為 對 realloc的呼叫。 realloc 和 _realloc_dbg 都會重新配置基底堆積中的記憶體區塊，但 _realloc_dbg 還容納數種偵錯功能：在區塊的使用者部分的任一端使用緩衝區以測試遺漏，以及追蹤特定配置類型的區塊類型參數，還有判斷配置要求來源的 filename/linenumber 資訊。
_realloc_dbg 會使用比要求的 newSize 稍多一些的空間重新配置指定的記憶體區塊。 newSize 可能會比原始配置的記憶體區塊大小更多或更少。 偵錯堆積管理員會使用額外的空間來連結偵錯記憶體區塊，並提供偵錯標頭資訊和覆寫緩衝區的應用程式。 重新配置可能會導致將原始記憶體區塊移至堆積中的不同位置，以及變更記憶體區塊的大小。 若記憶體區塊已移動，則會覆寫原始區塊的內容。
若記憶體配置失敗，或是所需的記憶體數量 (包含之前提到的額外負荷) 超過 _realloc_dbg，errno 會將 ENOMEM 設定為 _HEAP_MAXREQ。 如您需要此錯誤碼和其他錯誤碼的相關資訊，請參閱errno、 _doserrno_sys_errlist與 _sys_nerr。
如需如何在基底堆積偵錯版本中配置、初始化及管理記憶體區塊的相關信息，請參閱 CRT 偵錯堆積詳細數據。 如需配置區塊類型及其使用方式的相關信息，請參閱 偵錯堆積上的區塊類型。 如需有關標準堆積函式與偵錯版本差異的資訊，請參閱 堆積配置函式的偵錯版本。
需求
| 常式 | 必要的標頭 |
|---|---|
_realloc_dbg |
<crtdbg.h> |
如需相容性詳細資訊，請參閱相容性。
程式庫
僅限偵錯版本的 C 執行階段程式庫。
範例
請參閱文章中的 _msize_dbg 範例。