DownlevelGetParentLocaleName 函式

擷取所提供地區設定之父系的地區設定名稱。

注意

此函式僅供在 Windows Vista 前作業系統上執行的應用程式使用。 其使用需要下載套件。 只在 Windows Vista 和更新版本上執行的應用程式應該呼叫 GetLocaleInfo ，並將 LCType 設定為 LOCALE_SPARENT。

 

語法

int DownlevelGetParentLocaleName(
  _In_  LCID   Locale,
  _Out_ LPWSTR lpName,
  _In_  int    cchName
);

參數

地區設定 [in]

地區設定的地區設定標識碼 。 您可以使用 MAKELCID 宏來建立地區設定標識碼，或使用下列其中一個預先定義的值。

• LOCALE_INVARIANT
• LOCALE_SYSTEM_DEFAULT
• LOCALE_USER_DEFAULT

Windows Vista 和更新版本： 也支援下列自定義地區設定標識符。

• LOCALE_CUSTOM_DEFAULT
• LOCALE_CUSTOM_UI_DEFAULT
• LOCALE_CUSTOM_UNSPECIFIED

lpName [out]

函式擷取父地區設定名稱的緩衝區指標，或下列其中一個預先定義的值。 如果 cchName 設定為 0，此參數會設定為 NULL。

• LOCALE_NAME_INVARIANT
• LOCALE_NAME_SYSTEM_DEFAULT
• LOCALE_NAME_USER_DEFAULT

cchName [in]

以UTF-16字碼點表示的 lpName 所指示的緩衝區大小。 此參數的值為 0，會讓函式忽略 lpName 緩衝區，並傳回緩衝區的大小，以字元為單位（包含 Null 字元），以包含父地區設定名稱。

傳回值

如果成功，傳回地區設定名稱中的UTF-16字碼點計數，包括終止 Null 字元。

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

• ERROR_INSUFFICIENT_BUFFER。 提供的緩衝區大小不夠大，或設定為 NULL 不正確。
• ERROR_INVALID_PARAMETER。 任何參數值都無效。

備註

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

需求

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

另請參閱

國家語言支援

國家語言支援函式

對應地區設定數據

GetLocaleInfo