GetAcceptLanguagesA-Funktion (shlwapi.h)

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

Syntax

LWSTDAPI GetAcceptLanguagesA(
  [out]     LPSTR pszLanguages,
  [in, out] DWORD *pcchLanguages
);

Parameter

[out] pszLanguages

Typ: LPTSTR

Ein Zeiger auf eine Zeichenfolge, die nach 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, wobei 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 in Zeichen bei pszLanguages.

Bei einem Eintrag ist dieser Wert die Größe von pszLanguages, einschließlich des abschließenden NULL-Zeichens.

Beim Beenden ist dies die tatsächliche Größe von pszLanguages, ohne dass das abschließende NULL-Zeichen enthalten ist.

Rückgabewert

Typ: HRESULT

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

Hinweise

Für windows-Versionen, die GetAcceptLanguages nicht in Shlwapi.h enthalten, muss die individuelle ANSI- oder Unicode-Version dieser Funktion direkt aus Shlwapi.dll aufgerufen werden. GetAcceptLanguagesA ist Ordnungszahl 14 und GetAcceptLanguagesW ist Ordinal 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 in einem zusätzlichen Sprachheader gesendet, wenn HTTP-Verbindungen verhandelt werden.

Hinweis Wenn Ihre App oder Ihr Dienst Sprachtags von dieser Funktion an alle Funktionen für die Unterstützung nationaler Sprachen 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 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, 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)