GetAcceptLanguagesA 函式 (shlwapi.h)

擷取指定語言喜好設定時與網站搭配使用的字串。

語法

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

參數

[out] pszLanguages

類型： LPTSTR

當此函式成功傳回時，字串的指標會收到語言喜好設定資訊。 我們建議此緩衝區的大小為 2048 個字元，以確保有足夠的空間可傳回完整的字串。 您也可以呼叫這個函式，並將此參數設定為 NULL，以擷取將傳回的字串大小。

[in, out] pcchLanguages

類型： DWORD*

pszLanguages 字串的大小指標，以字元為單位。

在專案上，此值是 pszLanguages 的大小，包括終止的 Null 字元。

結束時，這是 pszLanguages 的實際大小，不包括終止的 Null 字元。

傳回值

類型： HRESULT

如果此函式成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

備註

對於未在 Shlwapi.h 中包含 GetAcceptLanguages 的 Windows 版本，必須直接從 Shlwapi.dll 呼叫此函式的個別 ANSI 或 Unicode 版本。 GetAcceptLanguagesA 為序數 14， 而 GetAcceptLanguagesW 為序數 15。

有些網站提供多種語言的內容。 您可以在 控制台 的 [因特網選項] 專案中指定您的語言喜好設定。 GetAcceptLanguages 會擷取代表這些喜好設定的字串。 在交涉 HTTP 連線時，該字串會以其他語言標頭傳送。

注意 如果您的應用程式或服務將語言標籤從此函式傳遞至任何 國家語言支援 函式，或傳遞至 Microsoft .NET，則必須先透過 ResolveLocaleName 函式轉換標記。

 

注意

shlwapi.h 標頭會將 GetAcceptLanguages 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。

規格需求

需求	值
最低支援的用戶端	Windows 2000 專業版、Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限傳統型應用程式]
目標平台	Windows
標頭	shlwapi.h
程式庫	Shlwapi.lib
Dll	Shlwapi.dll (5.0 版或更新版本)