Freigeben über


FreeResource-Funktion (libloaderapi.h)

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

Siehe auch

DeleteObject

DestroyAcceleratorTable

DestroyCursor

DestroyIcon

DestroyMenu

LoadResource

Andere Ressourcen

Referenz