FindResourceExW-Funktion (libloaderapi.h)

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

Syntax

HRSRC FindResourceExW(
  [in, optional] HMODULE hModule,
  [in]           LPCWSTR lpType,
  [in]           LPCWSTR lpName,
  [in]           WORD    wLanguage
);

Die 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 die ID der ganzzahlige Bezeichner des angegebenen Ressourcentyps ist. Standardressourcentypen finden Sie unter "Ressourcentypen". Weitere Informationen finden Sie im Abschnitt "Hinweise" weiter unten.

[in] lpName

Typ: LPCTSTR-

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

[in] wLanguage

Typ: WORD

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

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 die Funktion fehlschlägt, ist der Rückgabewert NULL. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.

Bemerkungen

Wenn IS_INTRESOURCEwahr für x = lpType oder lpName 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 Nummernzeichen (#) ist, stellen die verbleibenden Zeichen eine Dezimalzahl dar, die den ganzzahligen Bezeichner des Namens oder Typs der Ressource angibt. Beispielsweise stellt die Zeichenfolge "#258" den ganzzahligen Bezeichner 258 dar.

Um die für eine Ressource erforderliche Arbeitsspeichermenge zu verringern, sollte eine Anwendung anhand eines ganzzahligen Bezeichners 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 nachfolgende Aufrufe an LoadResource und dann an LockResource ausgeführt werden.

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.

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 das Symbol geladen wird, um seine Daten in eine andere Anwendung zu kopieren.

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

Anforderungen

Siehe auch

FindResource
FormatMessage
IS_INTRESOURCE
LoadAccelerators
LoadBitmap
LoadCursor
LoadIcon
LoadMenu
LoadResource
LoadString
MAKELANGID

andere Ressourcen

Referenz
Ressourcen