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 |