Funzione CoTaskMemAlloc (combaseapi.h)

Alloca un blocco di memoria dell'attività nello stesso modo in cui IMalloc::Alloc esegue.

Sintassi

LPVOID CoTaskMemAlloc(
  [in] SIZE_T cb
);

Parametri

[in] cb

Dimensioni del blocco di memoria da allocare, in byte.

Valore restituito

Se la funzione ha esito positivo, restituisce il blocco di memoria allocato. In caso contrario, restituisce NULL.

Commenti

CoTaskMemAlloc usa l'allocatore predefinito per allocare un blocco di memoria nello stesso modo in cui IMalloc::Alloc esegue. Non è necessario chiamare la funzione CoGetMalloc prima di chiamare CoTaskMemAlloc.

Il contenuto iniziale del blocco di memoria restituito non è definito. Non esiste alcuna garanzia che il blocco sia stato inizializzato. Il blocco allocato può essere maggiore di cb byte a causa dello spazio necessario per l'allineamento e per le informazioni di manutenzione.

Se cb è 0, CoTaskMemAlloc alloca un elemento di lunghezza zero e restituisce un puntatore valido a tale elemento. Se è disponibile memoria insufficiente, CoTaskMemAlloc restituisce NULL. Le applicazioni devono sempre controllare il valore restituito da questa funzione, anche quando si richiedono piccole quantità di memoria, perché non esiste alcuna garanzia che la memoria verrà allocata.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [app desktop | App UWP]
Server minimo supportato	Windows 2000 Server [app desktop | App UWP]
Piattaforma di destinazione	Windows
Intestazione	combaseapi.h (include Objbase.h)
Libreria	Ole32.lib
DLL	Ole32.dll

Vedi anche

CoTaskMemFree

CoTaskMemRealloc

IMalloc::Alloc