GetProcessPreferredUILanguages 函式 (winnls.h)
擷取程式慣用的 UI 語言。 如需詳細資訊，請參閱 使用者介面語言管理。
語法
BOOL GetProcessPreferredUILanguages(
[in] DWORD dwFlags,
[out] PULONG pulNumLanguages,
[out, optional] PZZWSTR pwszLanguagesBuffer,
[in, out] PULONG pcchLanguagesBuffer
);
參數
[in] dwFlags
旗標，識別用於程式慣用 UI 語言的語言格式。 旗標互斥，預設值為 MUI_LANGUAGE_NAME。
| 值 | 意義 |
|---|---|
|
擷取 語言識別項格式的語言 字串。 |
|
擷取 語言名稱 格式的語言字串。 |
[out] pulNumLanguages
pwszLanguagesBuffer中擷取之語言數目的指標。
[out, optional] pwszLanguagesBuffer
選擇性。 函式會依喜好設定順序擷取已排序、以 Null 分隔清單的雙 Null 終止多字串緩衝區指標，從最理想開始。
或者，如果此參數設定為 Null ， 而 pcchLanguagesBuffer 設定為 0，則函式會擷取 pcchLanguagesBuffer中語言緩衝區的必要大小。 所需的大小包含兩個 Null 字元。
[in, out] pcchLanguagesBuffer
pwszLanguagesBuffer所指示之語言緩衝區的大小指標，以字元為單位。 從函式成功傳回時，參數會包含所擷取語言緩衝區的大小。
或者，如果此參數設定為 0，且 pwszLanguagesBuffer 設定為 Null，則函式會擷取 pcchLanguagesBuffer中語言緩衝區的必要大小。
傳回值
如果成功或 FALSE，則傳回 TRUE 。否則傳回 TRUE 。 若要取得延伸的錯誤資訊，應用程式可以呼叫 GetLastError，這可以傳回下列其中一個錯誤碼：
- ERROR_INSUFFICIENT_BUFFER。 提供的緩衝區大小不夠大，或設定為 Null不正確。
- ERROR_INVALID_PARAMETER。 任何參數值都無效。
備註
根據應用程式指定的旗標，此函式可以擷取包含程式慣用 UI 語言的清單。 如果遇到重複的語言，函式只會擷取重複語言的第一個實例。
指定MUI_LANGUAGE_ID時，擷取的語言字串將會是十六進位語言識別項
不包含前置 0x，且長度為 4 個字元。 例如，將會傳回 en-US
as 「0409」 and en as 「0009」。
C# 簽章
[DllImport("Kernel32.dll", CharSet = CharSet.Auto)]
static extern System.Boolean GetProcessPreferredUILanguages(
System.UInt32 dwFlags,
ref System.UInt32 pulNumLanguages,
System.IntPtr pwszLanguagesBuffer,
ref System.UInt32 pcchLanguagesBuffer
);
規格需求
| 最低支援的用戶端 | Windows 7 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2008 R2 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | winnls.h (包含 Windows.h) |
| 程式庫 | Kernel32.lib |
| DLL | Kernel32.dll |