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 |