FindResourceExA-Funktion (winbase.h)

Artikel
03/06/2024

Bestimmt den Speicherort der Ressource mit dem angegebenen Typ, Namen und sprache im angegebenen Modul.

Syntax

HRSRC FindResourceExA(
  [in, optional] HMODULE hModule,
  [in]           LPCSTR  lpType,
  [in]           LPCSTR  lpName,
  [in]           WORD    wLanguage
);

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] lpType

Typ: LPCTSTR

Der Ressourcentyp. Alternativ kann dieser Parameter anstelle eines Zeigers MAKEINTRESOURCE(ID) sein, wobei ID der ganzzahlige Bezeichner des angegebenen ist.

Ressourcentyp. Informationen zu Standardressourcentypen finden Sie unter Ressourcentypen. Weitere Informationen finden Sie weiter unten im Abschnitt "Hinweise".

[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] wLanguage

Typ: WORD

Die Sprache der Ressource. Wenn dieser Parameter ist MAKELANGID(LANG_NEUTRAL, SUBLANG_NEUTRAL), wird die aktuelle Sprache verwendet, die dem aufrufenden Thread zugeordnet ist.

Um eine andere Sprache als die aktuelle Sprache anzugeben, verwenden Sie das MAKELANGID-Makro , um diesen Parameter zu erstellen. Weitere Informationen finden Sie unter MAKELANGID.

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 zu erhalten, ü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 = lpType oder lpNameTRUE ist, gibt x den ganzzahligen Bezeichner des Typs oder Namens der angegebenen Ressource an. Andernfalls handelt es sich bei diesen Parametern um lange Zeiger auf Zeichenfolgen, die null enden. Wenn das erste Zeichen der Zeichenfolge ein Pfundzeichen (#) ist, stellen die verbleibenden Zeichen eine Dezimalzahl dar, die den ganzzahligen Bezeichner des Ressourcennamens oder -typs angibt. Die Zeichenfolge "#258" stellt beispielsweise den ganzzahligen Bezeichner 258 dar.

Um den für eine Ressource erforderlichen Arbeitsspeicher zu reduzieren, sollte eine Anwendung auf sie mit einem ganzzahligen Bezeichner und nicht mit dem Namen verweisen.

Eine Anwendung kann FindResourceEx 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 besser verwendbare Form zu konvertieren.

Funktion	Aktion
FormatMessage	Lädt und formatiert einen Nachrichtentabelleneintrag.
LoadAccelerators	Lädt eine Zugriffstastentabelle.
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 FindResourceEx 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 (nicht notwendigerweise NULL-beendeten) Unicode-Zeichenfolgen gespeichert. Die LoadString-Funktion extrahiert die Zeichenfolgenressource aus dem entsprechenden Abschnitt.

Beispiele

Ein Beispiel finden Sie unter Erstellen einer Ressourcenliste.

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