Share via

VerLanguageNameW-Funktion (winver.h)

  • Artikel

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

Art: DWORD

Der Bezeichner für binäre Sprachen. Eine vollständige Liste der Sprachbezeichner finden Sie unter Sprachbezeichner.

Beispielsweise lautet die Beschreibungszeichenfolge, die dem Sprachbezeichner 0x040A zugeordnet ist, "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

Art: DWORD

Die Größe des Puffers in Zeichen, auf die von szLang verwiesen wird.

Rückgabewert

Art: DWORD

Der Rückgabewert ist die Größe der im Puffer zurückgegebenen Zeichenfolge in Zeichen. Dieser Wert enthält nicht das beendende NULL-Zeichen. 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 0. Unbekannte Sprachbezeichner erzeugen keine Fehler.

Hinweise

Diese Funktion funktioniert auf 16-, 32- und 64-Bit-Dateiimages.

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 im Falle eines Sprachkonflikts verfahren werden soll.

Hinweis

Der winver.h-Header definiert VerLanguageName 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 winver.h (einschließen von Windows.h)
Bibliothek Version.lib
DLL Api-ms-win-core-localization-l1-2-1.dll

Weitere Informationen

Übersicht über Versionsinformationen