EnumResourceNamesW-Funktion (libloaderapi.h)

  • Artikel

Listet Ressourcen eines angegebenen Typs in einem Binärmodul auf. Für Windows Vista und höher ist dies in der Regel eine sprachneutrale portable ausführbare Datei (LN-Datei ), und die Enumeration enthält auch Ressourcen aus den entsprechenden sprachspezifischen Ressourcendateien (MUI-Dateien), die lokalisierbare Sprachressourcen enthalten. Es ist auch möglich, dass hModule eine MUI-Datei angibt. In diesem Fall wird nur diese Datei nach Ressourcen durchsucht.

Syntax

BOOL EnumResourceNamesW(
  [in, optional] HMODULE          hModule,
  [in]           LPCWSTR          lpType,
  [in]           ENUMRESNAMEPROCW lpEnumFunc,
  [in]           LONG_PTR         lParam
);

Parameter

[in, optional] hModule

Typ: HMODULE

Ein Handle für ein zu durchsuchende Modul. Wenn es sich um eine LN-Datei handelt, werden ab Windows Vista entsprechende MUI-Dateien (sofern vorhanden) in die Suche einbezogen.

Wenn dieser Parameter NULL ist, entspricht dies der Übergabe eines Handles an das Modul, das zum Erstellen des aktuellen Prozesses verwendet wird.

[in] lpType

Typ: LPCTSTR

Der Typ der Ressource, für die der Name aufgelistet wird. Alternativ kann dieser Parameter anstelle eines Zeigers MAKEINTRESOURCE(ID) sein, wobei ID ein ganzzahliger Wert ist, der einen vordefinierten Ressourcentyp darstellt. Eine Liste der vordefinierten Ressourcentypen finden Sie unter Ressourcentypen. Weitere Informationen finden Sie weiter unten im Abschnitt Hinweise .

[in] lpEnumFunc

Typ: ENUMRESNAMEPROC

Ein Zeiger auf die Rückruffunktion, die für jeden aufgezählten Ressourcennamen oder jede ID aufgerufen werden soll. Weitere Informationen finden Sie unter ENUMRESNAMEPROC.

[in] lParam

Typ: LONG_PTR

Ein anwendungsdefinierter Wert, der an die Rückruffunktion übergeben wird. Dieser Parameter kann bei der Fehlerüberprüfung verwendet werden.

Rückgabewert

Typ: BOOL

Der Rückgabewert ist TRUE , wenn die Funktion erfolgreich ist, oder FALSE , wenn die Funktion keine Ressource des angegebenen Typs findet oder wenn die Funktion aus einem anderen Grund fehlschlägt. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Wenn IS_INTRESOURCE(lpszType) TRUE ist, gibt lpszType den ganzzahligen Bezeichner des angegebenen Ressourcentyps an. Andernfalls handelt es sich um einen Zeiger auf eine NULL-Zeichenfolge. Wenn das erste Zeichen der Zeichenfolge ein Pfundzeichen (#) ist, stellen die restlichen Zeichen eine Dezimalzahl dar, die den ganzzahligen Bezeichner des Ressourcentyps angibt. Die Zeichenfolge "#258" stellt beispielsweise den Bezeichner 258 dar.

Für jede gefundene Ressource ruft EnumResourceNames eine anwendungsdefinierte Rückruffunktion lpEnumFunc auf, wobei der Name oder die ID jeder gefundenen Ressource übergeben wird, sowie die verschiedenen anderen Parameter, die an EnumResourceNames übergeben wurden.

Alternativ können Anwendungen EnumResourceNamesEx aufrufen, was eine präzisere Kontrolle darüber bietet, welche Ressourcen aufgelistet werden.

Wenn eine Ressource über eine ID verfügt, wird die ID an die Rückruffunktion übergeben. andernfalls wird der Ressourcenname an die Rückruffunktion übergeben. Weitere Informationen finden Sie unter ENUMRESNAMEPROC.

Die EnumResourceNames-Funktion listet weiterhin Ressourcen auf, bis die Rückruffunktion FALSE zurückgibt oder alle Ressourcen aufgelistet wurden.

Ab Windows Vista können sich die aufgelisteten Ressourcen entweder in der LN-Datei oder in einer ihr zugeordneten MUI-Datei befinden, wenn hModule eine LN-Datei angibt. Wenn keine MUI-Dateien gefunden werden, werden nur Ressourcen aus der LN-Datei zurückgegeben. Die Reihenfolge, in der .mui-Dateien durchsucht werden, ist die übliche Suchreihenfolge des Resource Loader; Weitere Informationen finden Sie unter Language Management der Benutzeroberfläche . Sobald eine entsprechende MUI-Datei gefunden wurde, wird die MUI-Dateisuche beendet. Da alle MUI-Dateien, die einer einzelnen LN-Datei entsprechen, dieselben Ressourcentypen aufweisen, müssen nur die Ressourcen in der gefundenen MUI-Datei aufgelistet werden.

Die Enumeration enthält nie Duplikate: Wenn Ressourcen mit demselben Namen sowohl in der LN-Datei als auch in einer MUI-Datei enthalten sind, wird die Ressource nur einmal aufgelistet.

Beispiele

Ein Beispiel finden Sie unter Erstellen einer Ressourcenliste.

Anforderungen

   
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)
Bibliothek Kernel32.lib
DLL Kernel32.dll

Siehe auch

Konzept

Verweis