CoTaskMemAlloc-Funktion (combaseapi.h)

Weist einen Block des Aufgabenspeichers auf die gleiche Weise zu wie IMalloc::Alloc .

Syntax

LPVOID CoTaskMemAlloc(
  [in] SIZE_T cb
);

Parameter

[in] cb

Die Größe des zu zuweisenden Speicherblocks in Bytes.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt sie den zugeordneten Speicherblock zurück. Andernfalls wird NULL zurückgegeben.

Hinweise

CoTaskMemAlloc verwendet die Standardzuteilung, um einen Speicherblock auf die gleiche Weise wie IMalloc::Alloc zuzuweisen. Es ist nicht erforderlich, die CoGetMalloc-Funktion aufzurufen, bevor CoTaskMemAlloc aufgerufen wird.

Der anfängliche Inhalt des zurückgegebenen Speicherblocks ist nicht definiert. Es gibt keine Garantie, dass der Block initialisiert wurde. Der zugewiesene Block kann aufgrund des für die Ausrichtung und für Wartungsinformationen benötigten Speicherplatz größer als cb Bytes sein.

Wenn cb 0 ist, weist CoTaskMemAlloc 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 CoTaskMemAllocNULL zurück. Anwendungen sollten immer den Rückgabewert dieser Funktion überprüfen, auch wenn kleine Speichermengen angefordert werden, da keine Garantie dafür besteht, dass der Arbeitsspeicher zugewiesen wird.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [Desktop-Apps | UWP-Apps]
Zielplattform	Windows
Kopfzeile	combaseapi.h (include Objbase.h)
Bibliothek	Ole32.lib
DLL	Ole32.dll

Weitere Informationen

CoTaskMemFree

CoTaskMemRealloc

IMalloc::Alloc