LoadResource-Funktion (libloaderapi.h)

Artikel
08/24/2023

Ruft ein Handle ab, mit dem ein Zeiger auf das erste Byte der angegebenen Ressource im Arbeitsspeicher abgerufen werden kann.

Syntax

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

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 FindResource - oder FindResourceEx-Funktion zurückgegeben.

Rückgabewert

Typ: HGLOBAL

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Handle für die Daten, die der Ressource zugeordnet sind.

Wenn bei der Funktion ein Fehler auftritt, ist der Rückgabewert NULL. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

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

GlobalSize gibt 0 für eine Ressource HGLOBAL zurück. Daher funktionieren alle APIs, die von GlobalSize abhängig sind, um die Größe von HGLOBAL zu bestimmen, 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	Aktion	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
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