DownlevelLocaleNameToLCID 函式

將地區設定名稱轉換為地區設定標識碼，可用來從操作系統取得資訊。

注意

此函式僅供在 Windows Vista 前作業系統上執行的應用程式使用。 其使用需要下載套件。 只在 Windows Vista 和更新版本上執行的應用程式應該呼叫 LocaleNameToLCID 來擷取地區設定標識碼。

 

語法

LCID DownlevelLocaleNameToLCID(
  _In_ LPWSTR lpName,
  _In_ DWORD  dwFlags
);

參數

lpName [in]

代表地區設定名稱之 Null 終止字串的指標。

dwFlags [in]

指定名稱類型的旗標。 預設值為 DOWNLEVEL_LOCALE_NAME。

傳回值

如果成功，會傳回對應至地區設定名稱的地區設定標識符。

如果函式未成功，則傳回 0。 若要取得擴充的錯誤資訊，應用程式可以呼叫 GetLastError，以傳回下列其中一個錯誤碼：

• ERROR_INVALID_FLAGS。 為旗標的值無效。
• ERROR_INVALID_PARAMETER。 任何參數值都無效。

備註

注意

此函式不支援中性地區設定。 對等 的 LocaleNameToLCID 函式支援 自定義地區設定，但僅適用於 Windows Vista 和更新版本。

 

必要的頭檔與 DLL 是「Microsoft NLS 下層數據對應 API」下載的一部分，此下載已無法再從 Microsoft 下載中心取得。 在 Windows 10 2019 年 5 月更新 和更新版本上使用ICU全球化 API。

需求

需求	值
最低支援的用戶端	Windows XP [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2003 [僅限傳統型應用程式]
可轉散發套件	Windows XP 上的 Microsoft NLS 下層數據對應 API 與 SP2 和更新版本Windows Vista
頁首	Nlsdl.h
DLL	NlsMap.dll

另請參閱

國家語言支援

國家語言支援函式

對應地區設定數據

LocaleNameToLCID