FreeResource-Funktion (libloaderapi.h)

Artikel
03/01/2024

Hinweis

Diese Funktion ist veraltet und wird nur aus Gründen der Abwärtskompatibilität mit 16-Bit-Windows unterstützt. Für 32-Bit-Windows-Anwendungen ist es nicht erforderlich, die mit LoadResource geladenen Ressourcen freizugeben. Bei modernen Versionen von Windows gibt diese Funktion immer FALSE zurück.

Verringert (verringert) die Verweisanzahl einer geladenen Ressource um eins. Wenn die Verweisanzahl null erreicht, wird der von der Ressource belegte Arbeitsspeicher freigegeben.

Syntax

BOOL FreeResource(
  [in] HGLOBAL hResData
);

Parameter

[in] hResData

Typ: HGLOBAL

Ein Handle der Ressource. Es wird davon ausgegangen, dass hglbResource von LoadResource erstellt wurde.

Rückgabewert

Typ: BOOL

Wenn die Funktion erfolgreich ist, ist der Rückgabewert „0“.

Wenn die Funktion fehlschlägt, ist der Rückgabewert ungleich null, was angibt, dass die Ressource nicht freigegeben wurde.

Hinweise

Für Ressourcen, die mit anderen Funktionen geladen wurden, wurde FreeResource durch die folgenden Funktionen ersetzt:

Ressourcentyp	FreeResource-Ersatz
Accelerator	DestroyAcceleratorTable
Bitmap	DeleteObject
Cursor	DestroyCursor
Symbol	DestroyIcon
Menü	DestroyMenu

Die Referenzanzahl für eine Ressource wird bei jedem Aufruf der LoadResource-Funktion für die Ressource durch eine Anwendung erhöht (um eins erhöht).

Das System löscht diese Ressourcen automatisch, wenn der Prozess beendet wird, von dem sie erstellt wurden. Der Aufruf der entsprechenden Funktion spart jedoch Arbeitsspeicher. Weitere Informationen finden Sie unter LoadResource.

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	libloaderapi.h (Einschließen von Windows.h)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll