EnumResourceLanguagesW-Funktion (winbase.h)

Artikel
03/06/2024

Listet sprachspezifische Ressourcen des angegebenen Typs und Namens auf, die einem binären Modul zugeordnet sind.

Syntax

BOOL EnumResourceLanguagesW(
  [in] HMODULE          hModule,
  [in] LPCWSTR          lpType,
  [in] LPCWSTR          lpName,
  [in] ENUMRESLANGPROCW lpEnumFunc,
  [in] LONG_PTR         lParam
);

Parameter

[in] hModule

Typ: HMODULE

Das Handle für ein zu durchsuchende Modul. Wenn es sich ab Windows Vista um eine sprachneutrale portable ausführbare Datei (LN-Datei ) handelt, werden entsprechende MUI-Dateien (sofern vorhanden) in die Suche einbezogen. Wenn es sich um eine bestimmte MUI-Datei handelt, wird nur diese Datei nach Ressourcen durchsucht.

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 Ressourcentyp, für den die Sprache 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] lpName

Typ: LPCTSTR

Der Name der Ressource, für die die Sprache aufgezählt wird. 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] lpEnumFunc

Typ: ENUMRESLANGPROC

Ein Zeiger auf die Rückruffunktion, die für jede aufgezählte Ressourcensprache aufgerufen werden soll. Weitere Informationen finden Sie unter EnumResLangProcW.

[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

Gibt TRUE zurück, wenn der Vorgang erfolgreich war, oder andernfalls FALSE . Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Wenn IS_INTRESOURCE(lpType) TRUE ist, gibt lpType 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.

Wenn IS_INTRESOURCE(lpName) true ist, gibt lpName den ganzzahligen Bezeichner der angegebenen Ressource 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 der Ressource angibt.

Ab Windows Vista ist das Binärmodul 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.

Für jede gefundene Ressource ruft EnumResourceLanguages eine anwendungsdefinierte Rückruffunktion lpEnumFunc auf und übergibt den Sprachbezeichner (siehe Sprachbezeichner) der Sprache, für die eine Ressource gefunden wurde, sowie die verschiedenen anderen Parameter, die an EnumResourceLanguages übergeben wurden.

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

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

Wenn hModule in Windows Vista und höher eine LN-Datei angibt, können sich die aufgelisteten Ressourcen entweder in der LN-Datei oder in einer ihr zugeordneten MUI-Datei befinden. Wenn keine MUI-Dateien gefunden werden, werden nur Ressourcen aus der LN-Datei zurückgegeben. Im Gegensatz zu EnumResourceNames und EnumResourceTypes werden bei dieser Suche mehrere MUI-Dateien untersucht. Die Enumeration beginnt mit MUI-Dateien in den Ordnern, die EnumUILanguages zugeordnet sind. Darauf folgen alle anderen MUI-Dateien, deren Pfade dem unter MUI Resource Management beschriebenen Schema entsprechen. Schließlich wird auch die von hModule angegebene Datei durchsucht.

Die Enumeration enthält nie Duplikate: Wenn eine Ressource mit demselben Namen, Typ und derselben Sprache sowohl in der LN-Datei als auch in einer MUI-Datei enthalten ist, wird die Ressource nur einmal aufgelistet.

Beispiele

Ein Beispiel finden Sie unter Erstellen einer Ressourcenliste.

Hinweis

Der winbase.h-Header definiert EnumResourceLanguages 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 nicht codierungsneutralem Code 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
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 (einschließlich Windows.h)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll