_aligned_recalloc

變更使用 _aligned_malloc 或 _aligned_offset_malloc 配置的記憶體區塊大小，並將記憶體初始化為 0。

語法

void * _aligned_recalloc(
   void *memblock,
   size_t num,
   size_t size,
   size_t alignment
);

參數

memblock
目前記憶體區塊指標。

number
項目的數目。

size
每個項目的大小 (位元組)。

alignment
對齊值，必須是 2 的整數冪。

傳回值

_aligned_recalloc 會傳回重新配置後 (且可能有移動) 記憶體區塊的 Void 指標。 如果大小為零且緩衝區引數不是 NULL ，或沒有足夠的可用記憶體將區塊擴充為指定的大小，則傳回值 NULL 為 。 在第一種情況中，會釋放原始區塊。 在第二種情況中，原始區塊會保留不變。 傳回值會指向適合儲存任何類型的物件的儲存空間。 若要取得 Void 類型以外的指標，請對傳回值使用類型轉換。

重新配置記憶體並變更區塊的對齊方式時發生錯誤。

備註

_aligned_recalloc 是以 malloc 為基礎。 如需有關使用 _aligned_offset_malloc 的詳細資訊，請參閱malloc。

若記憶體配置失敗，或是要求的大小大於 errno，則此函式會將 ENOMEM 設為 _HEAP_MAXREQ。 如需 的詳細資訊 errno ，請參閱 errno 、 _doserrno_sys_errlist 和 _sys_nerr 。 此外，_aligned_recalloc 也會驗證其參數。 如果 alignment 不是 2 的電源，此函式會叫用不正確參數處理常式，如參數驗證 中所述 。 若允許繼續執行，此函式會傳回 NULL，並將 errno 設為 EINVAL。

根據預設，此函式的全域狀態會限定于應用程式。 若要變更此行為，請參閱 CRT 中的全域狀態。

需求

常式	必要的標頭
_aligned_recalloc	<malloc.h>

另請參閱

資料對齊方式
_recalloc
_aligned_offset_recalloc