VerLanguageNameW-Funktion (winver.h)
Ruft eine Beschreibungszeichenfolge für die Sprache ab, die einem angegebenen binären Microsoft-Sprachbezeichner zugeordnet ist.
Syntax
DWORD VerLanguageNameW(
[in] DWORD wLang,
[out] LPWSTR szLang,
[in] DWORD cchLang
);
Parameter
[in] wLang
Typ: DWORD-
Der Binäre Sprachbezeichner. Eine vollständige Liste der Sprachbezeichner finden Sie unter Sprachbezeichner.
Beispielsweise lautet die Beschreibungszeichenfolge, die dem Sprachbezeichner zugeordnet ist, 0x040A "Spanisch (traditionelle Sortierung)". Wenn der Bezeichner unbekannt ist, verweist der szLang Parameter auf eine Standardzeichenfolge ("Language Neutral").
[out] szLang
Typ: LPTSTR-
Die vom wLang Parameter angegebene Sprache.
[in] cchLang
Typ: DWORD-
Die Größe des Puffers in Zeichen, auf den szLangverweist.
Rückgabewert
Typ: DWORD-
Der Rückgabewert ist die Größe der im Puffer zurückgegebenen Zeichenfolge in Zeichen. Dieser Wert enthält nicht das endende Nullzeichen. Wenn die Beschreibungszeichenfolge kleiner oder gleich dem Puffer ist, befindet sich die gesamte Beschreibungszeichenfolge im Puffer. Wenn die Beschreibungszeichenfolge größer als der Puffer ist, wird die Beschreibungszeichenfolge auf die Länge des Puffers abgeschnitten.
Wenn ein Fehler auftritt, ist der Rückgabewert null. Unbekannte Sprachbezeichner erzeugen keine Fehler.
Bemerkungen
Diese Funktion funktioniert in 16-, 32- und 64-Bit-Dateibildern.
In der Regel verwendet ein Installationsprogramm diese Funktion, um einen Sprachbezeichner zu übersetzen, der von der VerQueryValue--Funktion zurückgegeben wird. Die Textzeichenfolge kann in einem Dialogfeld verwendet werden, in dem der Benutzer gefragt wird, wie der Vorgang im Falle eines Sprachkonflikts fortgesetzt werden kann.
Anmerkung
Der winver.h-Header definiert VerLanguageName 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 |
---|---|
mindestens unterstützte Client- | Windows 2000 Professional [nur Desktop-Apps] |
mindestens unterstützte Server- | Windows 2000 Server [nur Desktop-Apps] |
Zielplattform- | Fenster |
Header- | winver.h (enthalten Windows.h) |
Library | Version.lib |
DLL- | Api-ms-win-core-localization-l1-2-1.dll |
Siehe auch
übersicht über Versionsinformationen