Funzione GetAcceptLanguagesA (shlwapi.h)

Articolo
03/02/2024

Recupera una stringa utilizzata con i siti Web quando si specificano le preferenze di lingua.

Sintassi

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

Parametri

[out] pszLanguages

Tipo: LPTSTR

Puntatore a una stringa che, quando questa funzione viene restituita correttamente, riceve le informazioni sulle preferenze della lingua. È consigliabile che questo buffer sia di dimensioni pari a 2048 caratteri per garantire spazio sufficiente per restituire la stringa completa. È anche possibile chiamare questa funzione con questo parametro impostato su NULL per recuperare le dimensioni della stringa che verrà restituita.

[in, out] pcchLanguages

Tipo: DWORD*

Puntatore alla dimensione, in caratteri, della stringa in pszLanguages.

Nella voce questo valore è la dimensione di pszLanguages, incluso il carattere null di terminazione.

All'uscita, è la dimensione effettiva di pszLanguages, non incluso il carattere null di terminazione.

Valore restituito

Tipo: HRESULT

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Per le versioni di Windows che non includono GetAcceptLanguages in Shlwapi.h, la singola versione ANSI o Unicode di questa funzione deve essere chiamata direttamente da Shlwapi.dll. GetAcceptLanguagesA è ordinale 14 e GetAcceptLanguagesW è ordinale 15.

Alcuni siti Web offrono contenuti in più lingue. È possibile specificare le preferenze di lingua nell'elemento Opzioni Internet in Pannello di controllo. GetAcceptLanguages recupera una stringa che rappresenta tali preferenze. Tale stringa viene inviata in un'intestazione di lingua aggiuntiva durante la negoziazione delle connessioni HTTP.

Nota Se l'app o il servizio passa tag di lingua da questa funzione a qualsiasi funzione di supporto per il linguaggio nazionale o a Microsoft .NET, deve prima convertire i tag tramite la funzione ResolveLocaleName .

Nota

L'intestazione shlwapi.h definisce GetAcceptLanguages come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional, Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	shlwapi.h
Libreria	Shlwapi.lib
DLL	Shlwapi.dll (versione 5.0 o successiva)

Condividi tramite