GetAcceptLanguagesA-Funktion (shlwapi.h)

Artikel
11/20/2024

Ruft eine Zeichenfolge ab, die bei der Angabe von Spracheinstellungen mit Websites verwendet wird.

Syntax

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

Parameter

[out] pszLanguages

Typ: LPTSTR-

Ein Zeiger auf eine Zeichenfolge, die, wenn diese Funktion erfolgreich zurückgegeben wird, die Spracheinstellungeninformationen empfängt. Es wird empfohlen, dass dieser Puffer 2048 Zeichen groß ist, um sicherzustellen, dass ausreichend Speicherplatz vorhanden ist, um die vollständige Zeichenfolge zurückzugeben. 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 bei pszLanguagesin Zeichen.

Bei der Eingabe ist dieser Wert die Größe von pszLanguages, einschließlich des endenden NULL-Zeichens.

Beim Beenden ist es die tatsächliche Größe von pszLanguages, nicht einschließlich des endenden NULL-Zeichens.

Rückgabewert

Typ: HRESULT-

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

Bemerkungen

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

Einige Websites bieten Inhalte in mehreren Sprachen an. Sie können Ihre Spracheinstellungen im Element "Internetoptionen" in der 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 Funktionen der nationalen Sprachunterstützung oder in Microsoft .NET übergibt, muss sie zuerst die Tags über die ResolveLocaleName--Funktion konvertieren.

Anmerkung

Der Header "shlwapi.h" definiert GetAcceptLanguages 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 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, Windows XP [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	shlwapi.h
Library	Shlwapi.lib
DLL-	Shlwapi.dll (Version 5.0 oder höher)

Freigeben über