CoTaskMemFree-Funktion (combaseapi.h)

Gibt einen Block des Aufgabenspeichers frei, der zuvor über einen Aufruf der Funktion CoTaskMemAlloc oder CoTaskMemRealloc zugeordnet wurde.

Syntax

void CoTaskMemFree(
  [in, optional] _Frees_ptr_opt_ LPVOID pv
);

Parameter

[in, optional] pv

Ein Zeiger auf den freizugebenden Speicherblock. Wenn dieser Parameter NULL ist, hat die Funktion keine Auswirkung.

Rückgabewert

Keine

Bemerkungen

Die CoTaskMemFree-Funktion verwendet die standardmäßige OLE-Zuweisung.

Die Anzahl der freigegebenen Bytes entspricht der Anzahl der Bytes, die ursprünglich zugeordnet oder neu zugeordnet wurden. Nach dem Aufruf ist der Speicherblock, auf den pv verweist, ungültig und kann nicht mehr verwendet werden.

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

CoTaskMemAlloc

CoTaskMemRealloc

IMalloc::Free