EnumResourceTypesA-Funktion (winbase.h)
Listet Ressourcentypen in einem binären Modul auf. Ab Windows Vista handelt es sich in der Regel um eine sprachneutralen portablen ausführbaren (LN-Datei) und die Enumeration enthält auch Ressourcen aus einer der entsprechenden sprachspezifischen Ressourcendateien (MUI-Dateien), sofern vorhanden, die lokalisierbare Sprachressourcen enthalten. Es ist auch möglich, hModule- zu verwenden, um eine MUI-Datei anzugeben, in diesem Fall wird nur diese Datei nach Ressourcentypen durchsucht.
Alternativ können Anwendungen EnumResourceTypesEx-aufrufen, wodurch genauer gesteuert wird, welche Ressourcendateien aufgezählt werden sollen.
Syntax
BOOL EnumResourceTypesA(
[in, optional] HMODULE hModule,
[in] ENUMRESTYPEPROCA lpEnumFunc,
[in] LONG_PTR lParam
);
Parameter
[in, optional] hModule
Typ: HMODULE-
Ein Handle zu einem modul, das durchsucht werden soll. Dieser Handle muss über LoadLibrary oder LoadLibraryExabgerufen werden.
Weitere Informationen finden Sie in den Hinweisen.
Wenn dieser Parameter NULL-ist, entspricht dies der Übergabe eines Handles an das Modul, das zum Erstellen des aktuellen Prozesses verwendet wird.
[in] lpEnumFunc
Typ: ENUMRESTYPEPROC
Ein Zeiger auf die Rückruffunktion, die für jeden aufgezählten Ressourcentyp aufgerufen werden soll. Weitere Informationen finden Sie in der EnumResTypeProc--Funktion.
[in] lParam
Typ: LONG_PTR
Ein anwendungsdefinierter Wert, der an die Rückruffunktion übergeben wird.
Rückgabewert
Typ: BOOL-
Gibt TRUE- zurück, wenn dies erfolgreich ist; andernfalls FALSE. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten.
Bemerkungen
Für jeden gefundenen Ressourcentyp ruft EnumResourceTypes eine anwendungsdefinierte Rückruffunktion lpEnumFuncauf, wobei jeder gefundene Ressourcentyp übergeben wird, sowie die verschiedenen anderen Parameter, die an EnumResourceTypesübergeben wurden.
EnumResourceTypes ressourcentypen weiter aufzählen, bis die Rückruffunktion FALSE zurückgibt oder alle Ressourcentypen aufgezählt wurden.
Beginnend mit Windows Vista, wenn hModule- eine LN-Datei angibt, entsprechen die aufgezählten Typen Ressourcen, die sich in der LN-Datei und in der zugehörigen MUI-Datei befinden. Wenn keine MUI-Dateien gefunden werden, werden nur Typen aus der LN-Datei zurückgegeben. Die Reihenfolge, in der MUI-Dateien durchsucht werden, ist die übliche Suchreihenfolge des Ressourcenladeprogramms; Weitere Informationen finden Sie unter Benutzeroberflächen-Sprachverwaltung. Nachdem eine entsprechende MUI-Datei gefunden wurde, wird die Suche nicht weiter mit anderen MUI-Dateien fortgesetzt, die der LN-Datei zugeordnet sind, da alle MUI-Dateien, die einer einzelnen LN-Datei entsprechen, dieselben Ressourcentypen aufweisen.
Die Enumeration enthält niemals Duplikate: Wenn ein bestimmter Ressourcentyp sowohl in der LN-Datei als auch in einer MUI-Datei enthalten ist, wird der Typ nur einmal aufgezählt.
Beispiele
Ein Beispiel finden Sie unter Erstellen einer Ressourcenliste.
Anmerkung
Der winbase.h-Header definiert EnumResourceTypes als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 2000 Professional [nur Desktop-Apps] |
| mindestens unterstützte Server- | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform- | Fenster |
| Header- | winbase.h (enthalten Windows.h) |
| Library | Kernel32.lib |
| DLL- | Kernel32.dll |
Siehe auch
Konzeptionelle
Referenz-