IMalloc::Alloc-Methode (objidl.h)

  • Artikel

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

Weitere Informationen

CoTaskMemAlloc

IMalloc