LoadMUILibraryW-Funktion (muiload.h)

Artikel
03/04/2024

Gibt ein Handle für 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 jeden Aufruf von LoadMUILibrary mit einem entsprechenden Aufruf von FreeMUILibrary abgleichen.

Syntax

HINSTANCE LoadMUILibraryW(
  [in] PCWSTR pszFullModuleName,
  [in] DWORD  dwLangConvention,
  [in] LANGID LangID
);

Parameter

[in] pszFullModuleName

Zeiger auf eine NULL-endende Zeichenfolge, die den Namen einer LN-Datei angibt.

[in] dwLangConvention

Flags, die die Namenskonvention unter Betriebssystemen vor Windows Vista 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, mithilfe des Sprachbezeichnerformats .
MUI_LANGUAGE_NAME	Interpretieren Sie den Namen des Ordners, der die sprachspezifischen Ressourcendateien enthält, mithilfe des Sprachnamenformats .

Das folgende Flag 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 Standard Modul, das von pwszModuleName angegeben wird, und geben Sie bei erfolgreicher Ausführung ein Handle an dieses Modul zurück.

[in] LangID

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

Rückgabewert

Gibt bei erfolgreicher Ausführung ein Handle für die entsprechende sprachspezifische Ressourcendatei zurück.

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

Hinweise

Mit dieser Funktion können Anwendungen, die mit der Win32 MUI-Ressourcentechnologie entwickelt wurden, die sprachspezifische Ressourcendatei richtig bestimmen, die auf Betriebssystemen vor Windows Vista geladen werden soll. Anwendungen, die diese Funktion verwenden, müssen nicht speziell unter Windows Vista erstellt werden, aber sie müssen statisch mit der MUILoad-Bibliothek verknüpft werden, 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, in der die Anwendung ausgeführt wird, die die Funktion aufruft
Im dwLangConvention-Parameter übergebenes Flag
Status des Sprachbezeichners, der im LangID-Parameter übergeben wird

Wenn sie unter Windows Vista ausgeführt wird, lädt diese Funktion das Standard-Modul ohne Umleitung. Es wird nur der Parameter pszFullModuleName verwendet, da die Ressourcenladeprogrammfunktionen beim Aufrufen der Umleitung entsprechend umgeleitet werden. Bei der Ausführung unter Betriebssystemen vor Windows Vista berücksichtigt diese Funktion alle Parameter, die die Anwendung bereitstellt. Es leitet binäres Laden an das richtige Satellitenbinärpaar um, das der durch pszFullModuleName dargestellten Datei zugeordnet ist. Dieser Prozess stellt den der Datei zugeordneten Pfad wieder her, um das Verhalten von Windows Vista nachzuahmen, das den Ressourcenladefunktionen zugrunde steht.

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 hexadezimalen Zeichenfolgenwerten untersucht. (Diese Werte enthalten nicht das führende 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, wobei sprachnamenbasierte Ordnertests verwendet werden, um eine Satellitendatei zu finden.

Der Status des Sprachbezeichners im LangID-Parameter wirkt sich auf die Ressourcenüberprüfung aus. Wenn die Anwendung diesen Parameter auf 0 festlegt, verwendet die Funktion die vom Betriebssystem abhängige vordefinierte Fallbacklogik, um die entsprechende sprachspezifische Ressourcendatei zu suchen. Wenn die Anwendung LangID auf einen Wert ungleich 0 (Null) festlegt, durchsucht der Untersuchungsmechanismus nur den entsprechend benannten Ordner und den zugeordneten neutralen Äquivalent. Weitere Informationen finden Sie unter Benutzeroberflächensprachverwaltung.

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

Hinweis

Der Muiload.h-Header definiert LoadMUILibrary als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch 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
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	muiload.h
Bibliothek	Muiload.lib
Verteilbare Komponente	Muiload.lib, im Windows SDK für Windows 7 enthalten, 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.

Weitere Informationen

FreeMUILibrary

Multilingual User Interface

Mehrsprachige Benutzeroberflächenfunktionen

Share via