GetAcceptLanguagesW-Funktion (shlwapi.h)

  • Artikel

Ruft eine Zeichenfolge ab, die mit Websites verwendet wird, wenn Spracheinstellungen angegeben werden.

Syntax

LWSTDAPI GetAcceptLanguagesW(
  [out]     LPWSTR pszLanguages,
  [in, out] DWORD  *pcchLanguages
);

Parameter

[out] pszLanguages

Typ: LPTSTR

Ein Zeiger auf eine Zeichenfolge, die bei erfolgreicher Rückgabe dieser Funktion die Informationen zu den Spracheinstellungen empfängt. Es wird empfohlen, dass dieser Puffer eine Größe von 2048 Zeichen hat, um sicherzustellen, dass genügend Speicherplatz zum Zurückgeben der vollständigen Zeichenfolge vorhanden ist. Sie können diese Funktion auch aufrufen, wenn dieser Parameter auf NULL festgelegt ist, um die Größe der zurückgegebenen Zeichenfolge abzurufen.

[in, out] pcchLanguages

Typ: DWORD*

Ein Zeiger auf die Größe der Zeichenfolge bei pszLanguages in Zeichen.

Beim Eintrag entspricht dieser Wert der Größe von pszLanguages, einschließlich des beendenden NULL-Zeichens.

Beim Beenden ist es die tatsächliche Größe von pszLanguages, ohne das beendende NULL-Zeichen.

Rückgabewert

Typ: HRESULT

Wenn diese Funktion erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Für windows-Versionen, die GetAcceptLanguages in Shlwapi.h nicht enthalten, muss die individuelle ANSI- oder Unicode-Version dieser Funktion direkt aus Shlwapi.dll aufgerufen werden. GetAcceptLanguagesA ist Ordnungszahl 14 und GetAcceptLanguagesW ist Ordnungszahl 15.

Einige Websites bieten Inhalte in mehreren Sprachen an. Sie können Ihre Spracheinstellungen im Element Internetoptionen in Systemsteuerung angeben. GetAcceptLanguages ruft eine Zeichenfolge ab, die diese Einstellungen darstellt. Diese Zeichenfolge wird beim Aushandeln von HTTP-Verbindungen in einem zusätzlichen Sprachheader gesendet.

Hinweis Wenn Ihre App oder Ihr Dienst Sprachtags von dieser Funktion an alle Funktionen der National Language Support oder an Microsoft .NET übergibt, müssen die Tags zuerst über die ResolveLocaleName-Funktion konvertiert werden.
 

Hinweis

Der shlwapi.h-Header definiert GetAcceptLanguages 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 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, Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile shlwapi.h
Bibliothek Shlwapi.lib
DLL Shlwapi.dll (Version 5.0 oder höher)