IMalloc::Alloc-Methode (objidl.h)
Belegt einen Speicherblock.
Syntax
void * Alloc(
[in] SIZE_T cb
);
Parameter
[in] cb
Die Größe des zuzuordnenden Speicherblocks in Bytes.
Rückgabewert
Wenn die Methode erfolgreich ist, ist der Rückgabewert ein Zeiger auf den zugeordneten Speicherblock. Andernfalls ist er NULL.
Anwendungen sollten immer den Rückgabewert dieser Methode überprüfen, auch wenn sie kleine Speichermengen anfordern, da keine Garantie besteht, dass der Arbeitsspeicher zugeordnet wird.
Hinweise
Der anfängliche Inhalt des zurückgegebenen Speicherblocks ist nicht definiert, und es gibt keine Garantie, dass der Block initialisiert wurde. Daher sollten Sie ihn im Code initialisieren. Der zugeordnete Block kann aufgrund des für die Ausrichtung und für Wartungsinformationen erforderlichen Speicherplatzes größer als cb Bytes sein.
Wenn cb null ist, weist Alloc ein Element der Länge null zu und gibt einen gültigen Zeiger auf dieses Element zurück. Wenn nicht genügend Arbeitsspeicher verfügbar ist, gibt AllocNULL zurück.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | objidl.h |