DownlevelGetParentLocaleName 函式

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

注意

只有在 Windows Vista 之前的作業系統上執行的應用程式,才會使用此函式。 其用途需要下載套件。 只有在 Windows Vista 和更新版本上執行的應用程式,應該呼叫 GetLocaleInfo ,並將 LCType 設定為 地區設定 _ SPARENT

語法

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

參數

地區 [ 設定在]

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

Windows Vista 和更新版本: 也支援下列自訂地區設定識別碼。

lpName [擴展]

緩衝區的指標,函式會在其中抓取父地區設定名稱,或下列其中一個預先定義的值。 如果 cchName 設為0,則這個參數會設定為 Null

cchName [在]

LpName 在 utf-16 程式碼點中指出的緩衝區大小。 這個參數的值為0時,會導致函式忽略 lpName 緩衝區,並傳回緩衝區的大小(以包含父地區設定名稱的字元 (null 字元) )。

傳回值

傳回地區設定名稱中 UTF-16 程式碼點的計數,如果成功,則包含終止的 null 字元。

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

  • _緩衝區不足 _ 的錯誤。 提供的緩衝區大小不夠大,或未正確設定為 Null
  • 錯誤 _ 無效 _ 的參數。 任何參數值都無效。

備註

必要的標頭檔和 DLL 是「Microsoft NLS 下層資料對應 Api」下載的一部分,可在 Microsoft 下載中心取得。

規格需求

需求
最低支援的用戶端
[僅限 WINDOWS XP desktop 應用程式]
最低支援的伺服器
僅限 Windows Server 2003 [ desktop 應用程式]
可轉散發套件
Microsoft NLS 下層資料對應 Api 于 windows XP SP2 和更新版本
標頭
Nlsdl。h
DLL
NlsMap.dll

另請參閱

國家語言支援

國家語言支援功能

對應地區設定資料

GetLocaleInfo