FindResourceA-Funktion (winbase.h)

Artikel
08/27/2023

Bestimmt den Speicherort einer Ressource mit dem angegebenen Typ und Namen im angegebenen Modul.

Um eine Sprache anzugeben, verwenden Sie die FindResourceEx-Funktion .

Syntax

HRSRC FindResourceA(
  [in, optional] HMODULE hModule,
  [in]           LPCSTR  lpName,
  [in]           LPCSTR  lpType
);

Parameter

[in, optional] hModule

Typ: HMODULE

Ein Handle für das Modul, dessen portable ausführbare Datei oder eine zugehörige MUI-Datei die Ressource enthält. Wenn dieser Parameter NULL ist, durchsucht die Funktion das Modul, das zum Erstellen des aktuellen Prozesses verwendet wird.

[in] lpName

Typ: LPCTSTR

Der Name der Ressource. Alternativ kann dieser Parameter anstelle eines Zeigers MAKEINTRESOURCE(ID) sein, wobei ID der ganzzahlige Bezeichner der Ressource ist. Weitere Informationen finden Sie weiter unten im Abschnitt Hinweise.

[in] lpType

Typ: LPCTSTR

Der Ressourcentyp. Alternativ kann dieser Parameter anstelle eines Zeigers MAKEINTRESOURCE(ID) sein, wobei ID der ganzzahlige Bezeichner des angegebenen Ressourcentyps ist. Standardressourcentypen finden Sie unter Ressourcentypen. Weitere Informationen finden Sie weiter unten im Abschnitt Hinweise.

Rückgabewert

Typ: HRSRC

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Handle für den Informationsblock der angegebenen Ressource. Um ein Handle für die Ressource abzurufen, übergeben Sie dieses Handle an die LoadResource-Funktion .

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

Hinweise

Wenn IS_INTRESOURCE für x = lpName oder lpTypeTRUE ist, gibt x den ganzzahligen Bezeichner des Namens oder Typs der angegebenen Ressource an. Andernfalls sind diese Parameter lange Zeiger auf NULL-beendete Zeichenfolgen. Wenn das erste Zeichen der Zeichenfolge ein Pfundzeichen (#) ist, stellen die restlichen Zeichen eine Dezimalzahl dar, die den ganzzahligen Bezeichner des Namens oder Typs der Ressource angibt. Die Zeichenfolge "#258" stellt beispielsweise den ganzzahligen Bezeichner 258 dar.

Um den für eine Ressource erforderlichen Arbeitsspeicher zu reduzieren, sollte eine Anwendung mit ganzzahligem Bezeichner anstelle des Namens darauf verweisen.

Eine Anwendung kann FindResource verwenden, um einen beliebigen Ressourcentyp zu finden. Diese Funktion sollte jedoch nur verwendet werden, wenn die Anwendung auf die binären Ressourcendaten zugreifen muss, indem sie anschließend LoadResource und dann LockResource aufruft.

Um eine Ressource sofort zu verwenden, sollte eine Anwendung eine der folgenden ressourcenspezifischen Funktionen verwenden, um die Ressource zu finden und die Daten in eine verwendbarere Form zu konvertieren.

Funktion	Aktion
FormatMessage	Lädt und formatiert einen Nachrichtentabelleneintrag.
LoadAccelerators	Lädt eine Acceleratortabelle.
LoadBitmap	Lädt eine Bitmapressource.
LoadCursor	Lädt eine Cursorressource.
LoadIcon	Lädt eine Symbolressource.
LoadMenu	Lädt eine Menüressource.
LoadString	Lädt einen Zeichenfolgentabelleneintrag.

Beispielsweise kann eine Anwendung die LoadIcon-Funktion verwenden, um ein Symbol für die Anzeige auf dem Bildschirm zu laden. Die Anwendung sollte jedoch FindResource und LoadResource verwenden, wenn sie das Symbol lädt, um ihre Daten in eine andere Anwendung zu kopieren.

Zeichenfolgenressourcen werden in Abschnitten mit bis zu 16 Zeichenfolgen pro Abschnitt gespeichert. Die Zeichenfolgen in jedem Abschnitt werden als Sequenz von gezählten Unicode-Zeichenfolgen (nicht unbedingt null-beendet) gespeichert. Die LoadString-Funktion extrahiert die Zeichenfolgenressource aus dem entsprechenden Abschnitt.

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	winbase.h (einschließlich Windows.h)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll