DownlevelLCIDToLocaleName 函式

注意

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

語法

int DownlevelLCIDToLocaleName(
  _In_  LCID   Locale,
  _Out_ LPWSTR lpName,
  _In_  int    cchName,
  _In_  DWORD  dwFlags
);

地區設定 [in]

要轉譯的地區設定標識碼。您可以使用 MAKELCID 宏來建立地區設定識別碼。此函式不支援中性地區設定或下列特定的地區設定標識碼值。

lpName [out]

這個函式擷取地區設定名稱的緩衝區指標。如果 cchName 設定為 0，則函式會擷取 NULL。

cchName [in]

地區設定名稱緩衝區的UTF-16字碼點大小。應用程式會將此參數設定為 0，以傳回地區設定名稱緩衝區的必要大小。

dwFlags [in]

指定要擷取之名稱類型的旗標。預設值為 DOWNLEVEL_LOCALE_NAME。

如果成功，傳回地區設定名稱中的UTF-16字碼點計數，包括終止 Null 字元。如果函式成功且 cchName 的值為 0，則傳回值是地區設定名稱緩衝區所需的大小，以字元為單位（包括 Null 字元）。

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

注意

必要的頭檔與 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