DownlevelGetParentLocaleName 函式
擷取所提供地區設定之父系的地區設定 名稱 。
注意
此函式僅供在 Vista 作業系統前Windows上執行的應用程式使用。 其使用需要下載套件。 只有在 Windows Vista 和更新版本上執行的應用程式應該呼叫LCType設定為LOCALE_SPARENT的GetLocaleInfo。
語法
int DownlevelGetParentLocaleName(
_In_ LCID Locale,
_Out_ LPWSTR lpName,
_In_ int cchName
);
參數
-
地區設定 [in]
-
地區 設定的地區設定識別碼。 您可以使用 MAKELCID 宏來建立地區設定識別碼,或使用下列其中一個預先定義的值。
Windows Vista 和更新版本:也支援下列自訂地區設定識別碼。
-
lpName [out]
-
函式擷取父地區設定名稱或下列其中一個預先定義值的緩衝區指標。 如果cchName設定為 0,此參數會設定為Null。
-
cchName [in]
-
以 UTF-16 字碼點表示的 lpName所指示的緩衝區大小。 此參數的值為 0 會導致函式忽略 lpName 緩衝區,並傳回緩衝區的大小,以包含的 null) 字元 (null 字元為單位,必須包含父地區設定名稱。
傳回值
如果成功,則會傳回地區設定名稱中的 UTF-16 字碼點計數,包括終止 Null 字元。
如果函式未成功,此函式會傳回 0。 若要取得延伸的錯誤資訊,應用程式可以呼叫 GetLastError,這可以傳回下列其中一個錯誤碼:
- ERROR_INSUFFICIENT_BUFFER。 提供的緩衝區大小不夠大,或設定為 Null不正確。
- ERROR_INVALID_PARAMETER。 任何參數值都無效。
備註
必要的標頭檔與 DLL 是 Microsoft 下載中心提供的「Microsoft NLS 下層資料對應 API」下載的一部分。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 |
Windows XP [僅限傳統型應用程式] |
最低支援的伺服器 |
Windows Server 2003 [僅限桌面應用程式] |
可轉散發套件 |
Windows XP 上的 Microsoft NLS 下層資料對應 API 與 SP2 和更新版本 |
標頭 |
|
DLL |
|
另請參閱