Metodo IMalloc::Alloc (objidl.h)
Alloca un blocco di memoria.
Sintassi
void * Alloc(
[in] SIZE_T cb
);
Parametri
[in] cb
Dimensioni del blocco di memoria da allocare, in byte.
Valore restituito
Se il metodo ha esito positivo, il valore restituito è un puntatore al blocco di memoria allocato. In caso contrario, è NULL.
Le applicazioni devono sempre controllare il valore restituito da questo metodo, anche quando si richiedono piccole quantità di memoria, perché non esiste alcuna garanzia che la memoria venga allocata.
Commenti
Il contenuto iniziale del blocco di memoria restituito non è definito e non esiste alcuna garanzia che il blocco sia stato inizializzato, quindi è consigliabile inizializzarlo nel codice. 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 è zero, Alloc alloca un elemento di lunghezza zero e restituisce un puntatore valido a tale elemento. Se è disponibile memoria insufficiente, Alloc restituisce NULL.
Requisiti
Requisito | Valore |
---|---|
Client minimo supportato | Windows 2000 Professional [solo app desktop] |
Server minimo supportato | Windows 2000 Server [solo app desktop] |
Piattaforma di destinazione | Windows |
Intestazione | objidl.h |