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