Freigeben über


LoadResource-Funktion (libloaderapi.h)

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

Siehe auch

Konzept

Findresource

FindResourceEx

LoadLibrary

Loadmodule

LockResource

Andere Ressourcen

Referenz

Ressourcen