LoadResource-Funktion (libloaderapi.h)

2025-06-18

Ruft ein Handle ab, das zum Abrufen eines Zeigers auf das erste Byte der angegebenen Ressource im Arbeitsspeicher verwendet werden kann.

Syntax

HGLOBAL LoadResource(
  [in, optional] HMODULE hModule,
  [in]           HRSRC   hResInfo
);

Die Parameter

[in, optional] hModule

Typ: HMODULE-

Ein Handle für das Modul, dessen ausführbare Datei die Ressource enthält. Wenn hModuleNULL ist, lädt das System die Ressource aus dem Modul, das zum Erstellen des aktuellen Prozesses verwendet wurde.

[in] hResInfo

Typ: HRSRC

Ein Handle für die zu ladende Ressource. Dieses Handle wird von der Funktion FindResource oder FindResourceEx zurückgegeben.

Rückgabewert

Typ: HGLOBAL

Wenn die Funktion erfolgreich ist, handelt es sich bei dem Rückgabewert um ein Handle für die daten, die der Ressource zugeordnet sind.

Wenn die Funktion fehlschlägt, ist der Rückgabewert NULL-. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.

Bemerkungen

Der Rückgabetyp von LoadResource ist HGLOBAL aus Gründen der Abwärtskompatibilität, nicht weil die Funktion ein Handle an einen globalen Speicherblock zurückgibt. Übergeben Sie dieses Handle nicht an die GlobalLock - oder GlobalFree-Funktion . Rufen Sie die LockResource-Funktion auf, um einen Zeiger auf das erste Byte der Ressourcendaten abzurufen. um die Größe der Ressource abzurufen, rufen Sie SizeofResource auf.

GlobalSize gibt 0 für eine Ressource HGLOBAL zurück. Daher funktionieren alle APIs, die von GlobalSize abhängen, um die Größe des HGLOBAL zu ermitteln, nicht ordnungsgemäß. Verwenden Sie beispielsweise SHCreateMemStream anstelle von CreateStreamOnHGlobal.

Um eine Ressource sofort zu verwenden, sollte eine Anwendung die folgenden ressourcenspezifischen Funktionen verwenden, um die Ressource in einem Aufruf zu suchen und zu laden.

Funktion	Maßnahme	So entfernen Sie die Ressource
FormatMessage-	Lädt und formatiert einen Nachrichtentabelleneintrag	Keine Aktion erforderlich
LoadAccelerators	Lädt eine Zugriffstastentabelle	DestroyAcceleratorTable
LoadBitmap	Lädt eine Bitmapressource	DeleteObject-
LoadCursor	Lädt eine Cursorressource	DestroyCursor
LoadIcon	Lädt eine Symbolressource	DestroyIcon
LoadMenu	Lädt eine Menüressource	DestroyMenu
LoadString-	Lädt eine Zeichenfolgenressource	Keine Aktion erforderlich

Beispielsweise kann eine Anwendung die LoadIcon-Funktion verwenden, um ein Symbol für die Anzeige auf dem Bildschirm zu laden, gefolgt von DestroyIcon , wenn Sie fertig sind.

Beispiele

Ein Beispiel finden Sie unter Aktualisieren von Ressourcen.

Anforderungen

Anforderung	Wert
Mindestens unterstützter Client	Windows 2000 Professional [nur Desktop-Apps]
Mindestanforderungen für unterstützte Server	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Fenster
Überschrift	libloaderapi.h (include Windows.h)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll

Siehe auch

Freigeben über