LoadMUILibraryA-Funktion (muiload.h)

Gibt ein Handle an die sprachspezifischen Ressourcen zurück, die einer bestimmten sprachneutralen (LN)-Datei zugeordnet sind.

Hinweis Um sicherzustellen, dass die DLL ordnungsgemäß entladen wird, sollten Ihre Anwendungen mit jedem Aufruf von LoadMUILibrary mit einem entsprechenden Aufruf von FreeMUILibraryübereinstimmen.

 

Syntax

HINSTANCE LoadMUILibraryA(
  [in] PCSTR  pszFullModuleName,
  [in] DWORD  dwLangConvention,
  [in] LANGID LangID
);

Parameter

[in] pszFullModuleName

Zeigen Sie auf eine mit Null beendete Zeichenfolge, die den Namen einer LN-Datei angibt.

[in] dwLangConvention

Flags, die die Benennungskonvention für Vor-Windows Vista-Betriebssysteme angeben, um die Verzeichnisse zu benennen, die die sprachspezifischen Ressourcendateien enthalten. Die Flags schließen sich gegenseitig aus, und der Standardwert ist MUI_LANGUAGE_NAME.

Wert	Bedeutung
MUI_LANGUAGE_ID	Interpretieren Sie den Namen des Ordners, der die sprachspezifischen Ressourcendateien enthält, Sprachbezeichner Format.
MUI_LANGUAGE_NAME	Interpretieren Sie den Namen des Ordners, der die sprachspezifischen Ressourcendateien enthält, Sprachname Format.

 

Das folgende Kennzeichen ist als Option verfügbar und kann in Kombination mit einem der anderen Flags verwendet werden.

Wert	Bedeutung
MUI_LANGUAGE_EXACT	Wenn Ressourcen für die identifizierte Sprache in den Ressourcendateien nicht gefunden werden, überprüfen Sie das von pwszModuleName angegebene Hauptmodul, und geben Sie bei erfolgreicher Ausführung ein Handle an dieses Modul zurück.

[in] LangID

Sprachbezeichner für die Benutzeroberflächenressourcen auf einem Windows Vista-Betriebssystem. Der Sprachbezeichner kann nicht der Sprache entsprechen, die einer dieser Gebietsschemainformationskonstanten zugeordnet ist:

• LOCALE_SYSTEM_DEFAULT
• LOCALE_USER_DEFAULT
• LOCALE_CUSTOM_DEFAULT
• LOCALE_CUSTOM_UI_DEFAULT
• LOCALE_CUSTOM_UNSPECIFIED

Rückgabewert

Gibt ein Handle für die entsprechende sprachspezifische Ressourcendatei zurück, wenn dies erfolgreich ist.

Diese Funktion gibt NULL- zurück, wenn sie fehlschlägt. Um erweiterte Fehlerinformationen abzurufen, kann die Anwendung GetLastError-aufrufen.

Bemerkungen

Diese Funktion ermöglicht Anwendungen, die mit der Win32 MUI-Ressourcentechnologie entwickelt wurden, um die sprachspezifische Ressourcendatei korrekt zu ermitteln, die auf Vor-Windows Vista-Betriebssystemen geladen werden kann. Anwendungen, die diese Funktion verwenden, müssen nicht speziell auf Windows Vista erstellt werden, aber sie müssen statisch mit der MUILoad-Bibliothek verknüpfen, die im Microsoft Windows SDK für Windows Vista bereitgestellt wird. Für diese Funktion müssen die ausführbaren und sprachspezifischen Ressourcendateien mithilfe von Standardkonventionen gespeichert werden. Weitere Informationen zur Dateiplatzierung finden Sie unter Anwendungsbereitstellung.

Die folgenden Elemente beeinflussen das Laden von Satellitenbinärdateien durch diese Funktion.

• Betriebssystemversion, die die Anwendung ausführt, die die Funktion aufruft
• Flag, das im parameter dwLangConvention übergeben wird
• Status des Sprachbezeichners, der im parameter LangID übergeben wird

Wenn sie unter Windows Vista ausgeführt wird, lädt diese Funktion das Hauptmodul ohne Umleitung. Nur der pszFullModuleName Parameter wird verwendet, da die Ressourcenladefunktionen beim Aufrufen die Umleitung entsprechend ausführen. Bei der Ausführung unter Windows Vista-Betriebssystemen berücksichtigt diese Funktion alle Parameter, die die Anwendung bereitstellt. Es leitet binäres Laden an das richtige Satelliten-Binärpaar um, das der Datei zugeordnet ist, die durch pszFullModuleNamedargestellt wird. Durch diesen Vorgang wird der Pfad der Datei neu konfiguriert, um das Verhalten von Windows Vista nachzuahmen, das die Funktionen des Ressourcenladeprogramms unterlies.

Die Anwendung verwendet den dwLangConvention Parameter, um anzugeben, wie die Satellitenbinärdateien untersucht werden sollen. Wenn die Anwendung diesen Parameter auf MUI_LANGUAGE_ID festlegt, werden die Binärdateien in Ordnern mit Hexadezimalzeichenfolgenwerten untersucht. (Diese Werte enthalten nicht die führenden 0x und sind 4 Zeichen lang. Beispielsweise wird en-US dargestellt.

als "0409" und "en als "0009".) Wenn die Anwendung den Parameter auf MUI_LANGUAGE_NAME festlegt, verwendet die Funktion das Laden von Windows Vista-Ressourcen, bei dem sprachnamebasierte Ordnersonden verwendet werden, um eine Satellitendatei zu finden.

Der Status des Sprachbezeichners im LangID--Parameter wirkt sich auf das Probing von Ressourcen aus. Wenn die Anwendung diesen Parameter auf 0 festlegt, verwendet die Funktion die vordefinierte Fallbacklogik, abhängig vom Betriebssystem, um die entsprechende sprachspezifische Ressourcendatei zu suchen. Wenn die Anwendung LangID- auf einen Wert ungleich Null festlegt, durchsucht der Probingmechanismus nur den entsprechend benannten Ordner und dessen zugeordnetes neutrales Äquivalent. Weitere Informationen finden Sie unter User Interface Language Management.

LoadMUILibrary basiert auf der Funktion LoadLibraryEx, und ähnliche Überlegungen müssen auf die Verwendung angewendet werden. Insbesondere sollte FreeMUILibrary- für jedes von LoadMUILibraryzurückgegebene Handle aufgerufen werden. Außerdem sollte LoadMUILibrary nicht von DllMainaufgerufen werden. Weitere Informationen finden Sie in den Abschnitten "Hinweise" von LoadLibraryEx und FreeLibrary.

Anmerkung

Der Muiload.h-Header definiert LoadMUILibrary 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-	muiload.h
Library	Muiload.lib
redistributable	Muiload.lib, enthalten im Windows SDK für Windows 7, das unter Windows 2000 Professional, Windows 2000 Server, Windows XP, Windows Server 2003, Windows Vista, Windows Server 2008 und Windows 7 ausgeführt werden kann.

Siehe auch

FreeMUILibrary

Multilingual User Interface

Multilingual User Interface Functions