支援的 NLS 函式

國家語言支援 (NLS) 函式可協助遊戲支援特定語言與地區設定的行為。在 XBOX 上只能使用 WinNLS.h 中定義於 WINAPI_PARTITION_GAMES 分割區下的 API 函式。

標示為 DEPRECATED 的 API 在 GDK 上仍可運作,但有 Microsoft Docs 上所記載的注意事項。建議使用替代項目。

可用的函式

函式	狀態	替代項目
`EnumSystemLocalesEx`
`FindNLSStringEx`
`FoldStringA`
`GetACP`
`GetCurrencyFormatEx`
`GetGeoInfoEx`
`GetLocaleInfoEx`
`GetNumberFormatEx`
`GetStringTypeA`
`GetStringTypeExA`
`GetThreadLocale`
`GetUserDefaultGeoName`
`GetUserDefaultLocaleName`
`GetUserPreferredUILanguages`	NOT SUPPORTED	一律傳回 `en-US`
`IdnToAscii`
`IdnToUnicode`
`IsValidCodePage`
`IsValidLocaleName`
`LCIDToLocaleName`
`LCMapStringEx`
`LocaleNameToLCID`
`ResolveLocaleName`
`SetThreadLocale`
`CompareString`	DEPRECATED	`CompareStringEx`
`CompareStringA`	DEPRECATED	`CompareStringEx`
`EnumSystemLocalesA`	DEPRECATED	`EnumSystemLocalesEx`
`EnumSystemLocalesW`	DEPRECATED	`EnumSystemLocalesEx`
`FindNLSString`	DEPRECATED	`FindNLSStringEx`
`GetCPInfo`	DEPRECATED	使用 Unicode
`GetCPInfoExA`	DEPRECATED	使用 Unicode
`GetCPInfoExW`	DEPRECATED	使用 Unicode
`GetCurrencyFormatA`	DEPRECATED	`GetCurrencyFormatEx`
`GetCurrencyFormatW`	DEPRECATED	`GetCurrencyFormatEx`
`GetGeoInfoA`	DEPRECATED	`GetGeoInfoEx`
`GetGeoInfoW`	DEPRECATED	`GetGeoInfoEx`
`GetLocaleInfoA`	DEPRECATED	`GetLocaleInfoEx`
`GetLocaleInfoW`	DEPRECATED	`GetLocaleInfoEx`
`GetNumberFormatA`	DEPRECATED	`GetNumberFormatEx`
`GetNumberFormatW`	DEPRECATED	`GetNumberFormatEx`
`GetUserGeoID`	DEPRECATED	`GetUserDefaultLocaleName`
`LCMapStringA`	DEPRECATED	`LCMapStringEx`
`LCMapStringW`	DEPRECATED	`LCMapStringEx`

Game OS 的 NLS 函式不包含 Windows 所具備的完整語言大小寫對應表。無論地區設定為何,定序與大小寫轉換作業一律使用序數值。 請在當地語系化流程中處理區分文化特性的大小寫轉換與排序,而不是在執行階段處理。受影響的函式:

此清單並未詳列所有項目,其他標準 C++ 程式庫函式也可能相依於受影響的 API。