_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。
filename和linenumber參數才可以使用的時機_recalloc_dbg明確地呼叫或 _CRTDBG_MAP_ALLOC 巳經定義了前置處理器常數。
傳回值
如果成功地完成，這個函式傳回使用者部份的重新配置的記憶體區塊的指標、 呼叫新的處理常式函式，或是會傳回 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記憶體配置失敗時。 EINVAL會傳回所需的記憶體 (包括先前所述的額外負荷) 量若超過_HEAP_MAXREQ。如需這和其他錯誤碼資訊，請參閱errno、 _doserrno、 _sys_errlist 和 _sys_nerr。
如需有關如何記憶體區塊會配置、 初始化，而且在基底堆積的偵錯版本管理的資訊，請參閱記憶體管理和偵錯堆積。呼叫應用程式的偵錯組建中的標準的堆積函式對其偵錯版本之間的差異的相關資訊，請參閱使用偵錯版本與基底版本。
需求
常式 |
所需的標頭 |
|---|---|
_recalloc_dbg |
<crtdbg.h> |
如需相容性資訊，請參閱相容性在簡介中。
文件庫
偵錯版本的 C 執行階段程式庫只。
.NET Framework 對等用法
不適用。 若要呼叫標準的 c 函式，使用PInvoke。 如需詳細資訊，請參閱平台叫用範例。