FindResourceExW-Funktion (libloaderapi.h)

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

Syntax

HRSRC FindResourceExW(
  [in, optional] HMODULE hModule,
  [in]           LPCWSTR lpType,
  [in]           LPCWSTR 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 Ressourcentyps ist. 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, wird MAKELANGID(LANG_NEUTRAL, SUBLANG_NEUTRAL)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 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 = lpType oder lpNameTRUE ist, gibt x den ganzzahligen Bezeichner des Typs oder namens 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 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 nachfolgende Aufrufe von LoadResource und dann an LockResource durchführt.

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 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 Unicode-Zeichenfolgen (nicht unbedingt null-beendet) gespeichert. Die LoadString-Funktion extrahiert die Zeichenfolgenressource aus dem entsprechenden Abschnitt.

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ßlich Windows.h)
DLL	Kernel32.dll

Siehe auch

Findresource
FormatMessage
IS_INTRESOURCE
LoadAccelerators
LoadBitmap
LoadCursor
LoadIcon
LoadMenu
LoadResource
LoadString
MAKELANGID

Andere Ressourcen

Referenz
Ressourcen