_recalloc_dbg
重新配置陣列，並將其項目初始化為 0 (僅限偵錯版本)。
void *_recalloc_dbg( void *userData, size_t num, size_t size, int blockType, const char *filename, int linenumber );
參數
userData
之前配置的記憶體區塊的指標。num
要求的記憶體區塊數。size
要求的每個記憶體區塊大小 (位元組)。blockType
要求的記憶體區塊類型：_CLIENT_BLOCK 或 _NORMAL_BLOCK。如需配置區塊類型以及如何使用它們的詳細資訊，請參閱 偵錯堆積上的區塊類型。
filename
要求配置作業之原始程式檔的名稱的指標，或為 NULL。linenumber
原始程式檔中的行號，其中要求配置作業，或為 NULL。
只有在已明確呼叫 _recalloc_dbg，或是已定義 _CRTDBG_MAP_ALLOC 處理器常數時，才可以使用 filename 和 linenumber 參數。
傳回值
成功完成時，此函式會傳回重新配置記憶體區塊後的使用者部分的指標，呼叫新的處理常式函式，或是傳回 NULL。 如需傳回行為的完整說明，請參閱下列＜備註＞一節。 如需如何使用新的處理常式函式的詳細資訊，請參閱 _recalloc 函式。
備註
_recalloc_dbg 是偵錯版本的 _recalloc 函式。 當 _DEBUG 未定義時，每個 _recalloc_dbg 的呼叫會降至 _recalloc 的呼叫。 _recalloc 和 _recalloc_dbg 都會重新配置基底堆積中的記憶體區塊，但 _recalloc_dbg 還容納數種偵錯功能：在區塊的使用者部分的任一端使用緩衝區以測試遺漏，以及追蹤特定配置類型的區塊類型參數，還有判斷配置要求來源的 filename/linenumber 資訊。
_recalloc_dbg 會使用比要求的大小還要稍微多一些的空間重新配置指定的記憶體區塊 (num * size)，而要求的大小可能會比原始配置的記憶體區塊大小更大或更小。 偵錯堆積管理員會使用額外的空間連結偵錯記憶體區塊，以及為應用程式提供偵錯標頭資訊和覆寫緩衝區。 重新配置可能會導致將原始記憶體區塊移到堆積中的不同位置，也可能會變更記憶體區塊的大小。 區塊的使用者部分會填入值 0xCD，且每個覆寫緩衝區會填入 0xFD。
若記憶體配置失敗，_recalloc_dbg 會將 errno 設定為 ENOMEM；若所需的記憶體數量 (包含之前提到的額外負荷) 超過 _HEAP_MAXREQ，則會傳回 EINVAL。 如需此錯誤碼及其他錯誤碼的詳細資訊，請參閱 errno、_doserrno、_sys_errlist 和 _sys_nerr。
如需在偵錯版本的基底堆積中如何配置、初始化及管理記憶體區塊的資訊，請參閱＜CRT 偵錯堆積詳細資料＞。 如需在應用程式的偵錯組建中呼叫標準堆積函式以及其偵錯版本之間的差異的資訊，請參閱＜堆積配置函式的偵錯版本＞。
需求
常式 |
必要的標頭 |
|---|---|
_recalloc_dbg |
<crtdbg.h> |
如需相容性詳細資訊，請參閱＜簡介＞中的＜相容性＞。
程式庫
偵錯版本的 C 執行階段程式庫。
.NET Framework 對等用法
不適用。若要呼叫標準 C 函式，請使用 PInvoke。如需詳細資訊，請參閱＜平台叫用範例＞。