winnls.h 標頭

Windows 應用程式的國際化會使用此標頭。 如需詳細資訊，請參閱

• Windows 應用程式的國際化

winnls.h 包含下列程式設計介面：

函式

CompareString CompareString 函式 (winnls.h) 會比較識別碼所指定地區設定的兩個字元字串。
CompareStringA 比較識別碼所指定地區設定的兩個字元字串。警告 使用 CompareString 不正確可能會危害應用程式的安全性。 (CompareStringA)
ConvertDefaultLocale 將預設地區設定值轉換為實際的地區設定識別碼。
EnumCalendarInfoA 列舉指定地區設定的行事曆資訊。注意 除了行事曆資訊之外，若要接收行事曆識別碼，應用程式應該使用 EnumCalendarInfoEx 函式。 (ANSI)
EnumCalendarInfoExa 列舉識別碼所指定地區設定的行事曆資訊。注意 只有在 Windows Vista 和更新版本上執行的任何應用程式，都應該在此函式的喜好設定中使用 EnumCalendarInfoExEx。 (ANSI)
EnumCalendarInfoExEx 列舉名稱所指定地區設定的行事曆資訊。注意 應用程式應該依喜好設定呼叫此函式以 EnumCalendarInfo 或 EnumCalendarInfoEx，如果設計為只在 Windows Vista 和更新版本上執行。 注意 此函式可以列舉版本之間變更的資料，例如，因為自訂地區設定。 如果您的應用程式必須保存或傳輸資料，請參閱使用持續性地區設定資料。
EnumCalendarInfoExW 列舉識別碼所指定地區設定的行事曆資訊。注意 只有在 Windows Vista 和更新版本上執行的任何應用程式，都應該在此函式的喜好設定中使用 EnumCalendarInfoExEx。 (Unicode)
EnumCalendarInfoW 列舉指定地區設定的行事曆資訊。注意 除了行事曆資訊之外，若要接收行事曆識別碼，應用程式應該使用 EnumCalendarInfoEx 函式。 (Unicode)
EnumDateFormatsA 列舉指定地區設定可用的完整日期、簡短日期或年份/月格式。 (ANSI)
EnumDateFormatsExA 列舉指定地區設定可用的完整日期、簡短日期或年份/月格式。注意 只有在 Windows Vista 和更新版本上執行的任何應用程式都應該使用此函式的喜好設定 EnumDateFormatsExEx。 (ANSI)
EnumDateFormatsExEx 列舉名稱所指定地區設定可用的完整日期、簡短日期或年份/月格式。注意：如果設計為只在 Windows Vista 和更新版本上執行，則應用程式應該以喜好設定呼叫此函式至 EnumDateFormats 或 EnumDateFormatsEx。 注意 此函式可以列舉版本之間變更的資料，例如，因為自訂地區設定。 如果您的應用程式必須保存或傳輸資料，請參閱使用持續性地區設定資料。
EnumDateFormatsExW 列舉指定地區設定可用的完整日期、簡短日期或年份/月格式。注意 只有在 Windows Vista 和更新版本上執行的任何應用程式都應該使用此函式的喜好設定 EnumDateFormatsExEx。 (Unicode)
EnumDateFormatsW 列舉指定地區設定可用的完整日期、簡短日期或年份/月格式。 (Unicode)
EnumLanguageGroupLocalesA 列舉指定語言群組中的地區設定。 (ANSI)
EnumLanguageGroupLocalesW 列舉指定語言群組中的地區設定。 (Unicode)
EnumSystemCodePagesA 列舉作業系統所安裝或支援的字碼頁。 (ANSI)
EnumSystemCodePagesW 列舉作業系統所安裝或支援的字碼頁。 (Unicode)
EnumSystemGeoID 列舉作業系統上可用的地理位置識別碼， (類型 GEOID) 。
EnumSystemGeoNames 列舉兩個字母國際標準組織 (ISO) 3166-1 代碼或數值 United 一系列 M (UN) 系列 M，數位 49 (M.49) 代碼，這些地區位於作業系統上。
EnumSystemLanguageGroupsA 列舉作業系統所安裝或支援的語言群組。 (ANSI)
EnumSystemLanguageGroupsW 列舉作業系統所安裝或支援的語言群組。 (Unicode)
EnumSystemLocalesA 列舉作業系統所安裝或支援的地區設定。注意 基於互通性考慮，應用程式應該偏好 EnumSystemLocalesEx 函式為 EnumSystemLocales，因為 Microsoft 正移轉至使用地區設定名稱，而不是新地區設定的地區設定識別碼。 任何只會在 Windows Vista 和更新版本上執行的應用程式都應該使用 EnumSystemLocalesEx。 (ANSI)
EnumSystemLocalesEx 列舉作業系統所安裝或支援的地區設定。注意：如果設計為只在 Windows Vista 和更新版本上執行，應用程式應該以喜好設定呼叫此函式給 EnumSystemLocales。
EnumSystemLocalesW 列舉作業系統所安裝或支援的地區設定。注意 基於互通性考慮，應用程式應該偏好 EnumSystemLocalesEx 函式為 EnumSystemLocales，因為 Microsoft 正移轉至使用地區設定名稱，而不是新地區設定的地區設定識別碼。 任何只會在 Windows Vista 和更新版本上執行的應用程式都應該使用 EnumSystemLocalesEx。 (Unicode)
EnumTimeFormatsA 列舉識別碼所指定地區設定可用的時間格式。注意 基於互通性考慮，應用程式應該偏好 EnumTimeFormatsEx 函式為 EnumTimeFormats，因為 Microsoft 正移轉至使用地區設定名稱，而不是新地區設定的地區設定識別碼。 任何只在 Windows Vista 和更新版本上執行的應用程式都應該使用 EnumTimeFormatsEx。 (ANSI)
EnumTimeFormatsEx 列舉名稱所指定地區設定可用的時間格式。注意 如果設計為只在 Windows Vista 和更新版本上執行，應用程式應該以喜好設定呼叫此函式給 EnumTimeFormats。 注意 此函式可以列舉版本之間變更的資料，例如，因為自訂地區設定。 如果您的應用程式必須保存或傳輸資料，請參閱使用持續性地區設定資料。
EnumTimeFormatsW 列舉識別碼所指定地區設定可用的時間格式。注意 基於互通性考慮，應用程式應該偏好 EnumTimeFormatsEx 函式為 EnumTimeFormats，因為 Microsoft 正移轉至使用地區設定名稱，而不是新地區設定的地區設定識別碼。 任何只在 Windows Vista 和更新版本上執行的應用程式都應該使用 EnumTimeFormatsEx。 (Unicode)
EnumUILanguagesA 列舉作業系統上可用的使用者介面語言，並使用清單中的每個語言呼叫回呼函式。 (ANSI)
EnumUILanguagesW 列舉作業系統上可用的使用者介面語言，並使用清單中的每個語言呼叫回呼函式。 (Unicode)
FILEMUIINFO_GET_CULTURE 取得與 FILEMUIINFO 結構之 dwLanguageNameOffset 成員中語言名稱位移資訊相關聯的地區設定名稱。
FILEMUIINFO_GET_MAIN_TYPEID 取得與 FILEMUIINFO 結構中類型識別碼大小和位移相關聯的主要模組類型陣列專案。 此資訊會在 結構的 dwTypeIDMainSize 和 dwTypeIDMainOffset 成員中提供。
FILEMUIINFO_GET_MAIN_TYPEIDS 取得與 FILEMUIINFO 結構之 dwTypeIDMainOffset 成員中類型識別碼位移資訊相關聯的主要模組類型陣列。
FILEMUIINFO_GET_MAIN_TYPENAMES 取得與 FILEMUIINFO 結構之 dwTypeNameMainOffset 成員中類型名稱位移資訊相關聯的主要模組名稱多字串陣列。
FILEMUIINFO_GET_MUI_TYPEID 取得與 FILEMUIINFO 結構中類型識別碼大小和位移資訊相關聯的 MUI 模組類型陣列專案。 此資訊會在 結構的 dwTypeIDMUISize 和 dwTypeIDMUIOffset 成員中提供。
FILEMUIINFO_GET_MUI_TYPEIDS 取得與 FILEMUIINFO 結構之 dwTypeIDMUIOffset 成員中類型識別碼位移資訊相關聯的 MUI 模組類型陣列。
FILEMUIINFO_GET_MUI_TYPENAMES 取得 MUI 模組名稱與 FILEMUIINFO 結構之 dwTypeNameMUIOffset 成員中的類型名稱位移資訊相關聯的多字串陣列。
FindNLSString 在識別碼所指定地區設定的另一個 Unicode 字串中，找出 (寬字元) 或其對等專案。注意 因為具有非常不同二進位標記法的字串可以做為相同的比較，所以此函式可能會引發某些安全性考慮。 如需詳細資訊，請參閱安全性考慮：_International功能中的比較函式討論。 注意 基於互通性考慮，應用程式應該偏好 FindNLSStringEx 函式，因為 Microsoft 正移轉至使用地區設定名稱，而不是新地區設定的地區設定識別碼。 雖然 FindNLSString 支援自訂地區設定，但大部分的應用程式都應該針對這種類型的支援使用 FindNLSStringEx。
FindNLSStringEx 在名稱所指定地區設定的另一個 Unicode 字串中，找出 (寬字元) 或其對等專案。注意 因為具有非常不同二進位標記法的字串可以做為相同的比較，所以此函式可能會引發某些安全性考慮。 如需詳細資訊，請參閱安全性考慮：_International功能中的比較函式討論。
FoldStringA 將一個 Unicode 字串對應至另一個，並執行指定的轉換。 (FoldStringA)
GetACP 擷取作業系統目前的 Windows ANSI 字碼頁識別碼。注意 ANSI API 函式，例如 ANSI 版本的 TextOut，隱含地使用 GetACP 將文字轉譯成 Unicode 或從 Unicode 轉譯。
GetCalendarInfoA 擷取識別碼所指定地區設定之行事曆的相關資訊。 (ANSI)
GetCalendarInfoEx 擷取名稱所指定地區設定之行事曆的相關資訊。注意：如果設計為只在 Windows Vista 和更新版本上執行，應用程式應該優先呼叫 GetCalendarInfo 這個函式。 注意 此函式可以擷取版本之間變更的資料，例如，因為自訂地區設定。 如果您的應用程式必須保存或傳輸資料，請參閱使用持續性地區設定資料。
GetCalendarInfoW 擷取識別碼所指定地區設定之行事曆的相關資訊。 (Unicode)
GetCPInfo 擷取任何已安裝或可用字碼頁的相關資訊。 (GetCPInfo)
GetCPInfoExA 擷取任何已安裝或可用字碼頁的相關資訊。 (GetCPInfoExA)
GetCPInfoExW 擷取任何已安裝或可用字碼頁的相關資訊。 (GetCPInfoExW)
GetCurrencyFormatA 將數位字串格式化為識別碼所指定地區設定的貨幣字串。 (ANSI)
GetCurrencyFormatEx 將數位字串格式化為名稱所指定地區設定的貨幣字串。注意 如果設計為只在 Windows Vista 和更新版本上執行，應用程式應該以喜好設定呼叫此函式 GetCurrencyFormat。 注意 此函式可以格式化版本之間變更的資料，例如，因為自訂地區設定。 如果您的應用程式必須保存或傳輸資料，請參閱使用持續性地區設定資料。
GetCurrencyFormatW 將數位字串格式化為識別碼所指定地區設定的貨幣字串。 (Unicode)
GetDurationFormat 將時間持續時間格式化為識別碼所指定地區設定的時間字串。
GetDurationFormatEx 將時間持續時間格式化為名稱所指定地區設定的時間字串。
GetFileMUIInfo 擷取檔案的資源相關資訊。
GetFileMUIPath 擷取與所提供 LN 檔案相關聯之所有語言特定資源檔的路徑。 應用程式必須重複呼叫此函式，才能取得每個資源檔的路徑。
GetGeoInfoA 擷取指定地理位置的相關資訊。 (ANSI)
GetGeoInfoEx 擷取您使用兩個字母國際標準組織 (ISO) 3166-1 代碼或數值 United () 系列 M、數位 49 (M.49) 程式碼指定之地理位置的相關資訊。
GetGeoInfoW 擷取指定地理位置的相關資訊。 (Unicode)
GetLocaleInfoA 擷取識別碼所指定地區設定的相關資訊。 (ANSI)
GetLocaleInfoEx 擷取名稱所指定地區設定的相關資訊。注意 如果設計為只在 Windows Vista 和更新版本上執行，應用程式應該以喜好設定呼叫此函式至 GetLocaleInfo。 注意 此函式可以擷取版本之間變更的資料，例如，因為自訂地區設定。 如果您的應用程式必須保存或傳輸資料，請參閱使用持續性地區設定資料。
GetLocaleInfoW 擷取識別碼所指定地區設定的相關資訊。 (Unicode)
GetNLSVersion 擷取識別碼所指定地區設定之目前版本的指定 NLS 功能相關資訊。注意 基於互通性考慮，應用程式應該偏好 GetNLSVersionEx 函式至 GetNLSVersion，因為 Microsoft 正移轉至使用地區設定名稱，而不是新地區設定的地區設定識別碼。 這項建議特別適用于自訂地區設定，其中 GetNLSVersionEx 會擷取足夠的資訊，以判斷排序行為是否已變更。 只有在 Windows Vista 和更新版本上執行的任何應用程式都應該使用 GetNLSVersionEx，或至少在呼叫 GetNLSVersion 以取得其他排序版本設定資料時傳遞 NLSVERSIONINFOEX 結構。
GetNLSVersionEx 擷取名稱所指定地區設定的目前 NLS 功能版本相關資訊。注意：如果設計為只在 Windows Vista 和更新版本上執行，應用程式應該優先呼叫此函式至 GetNLSVersion。
GetNumberFormatA 將數位字串格式化為識別碼所指定地區設定所自訂的數位字串。 (ANSI)
GetNumberFormatEx 將數位字串格式化為依名稱所指定地區設定所自訂的數位字串。注意 如果設計為只在 Windows Vista 和更新版本上執行，應用程式應該以喜好設定呼叫此函式 GetNumberFormat。 注意 此函式可以格式化版本之間變更的資料，例如，因為自訂地區設定。 如果您的應用程式必須保存或傳輸資料，請參閱使用持續性地區設定資料。
GetNumberFormatW 將數位字串格式化為識別碼所指定地區設定所自訂的數位字串。 (Unicode)
GetOEMCP 傳回作業系統的目前原始設備製造商 (OEM) 字碼頁識別碼。
GetProcessPreferredUILanguages 擷取程式慣用的 UI 語言。 如需詳細資訊，請參閱使用者介面語言管理。
GetStringScripts 提供指定 Unicode 字串中使用的腳本清單。
GetStringTypeA 已取代。 (GetStringTypeA)
GetSystemDefaultLangID 傳回系統地區設定的語言識別項。
GetSystemDefaultLCID 傳回系統地區設定的地區設定識別碼。注意 只有在 Windows Vista 和更新版本上執行的任何應用程式都應該使用 GetSystemDefaultLocaleName 來設定此函式。
GetSystemDefaultLocaleName 擷取系統預設的地區設定名稱。注意 建議應用程式在此函式的喜好設定上呼叫 GetUserDefaultLocaleName。
GetSystemDefaultUILanguage 擷取作業系統之系統預設 UI 語言的語言識別項，也稱為 Windows Vista 和更新版本上的「安裝語言」。 如需詳細資訊，請參閱使用者介面語言管理。
GetSystemPreferredUILanguages 擷取系統慣用的 UI 語言。 如需詳細資訊，請參閱使用者介面語言管理。
GetThreadLocale 傳回呼叫執行緒目前地區設定的地區設定識別碼。注意 此函式可以擷取版本之間變更的資料，例如，因為自訂地區設定。
GetThreadPreferredUILanguages 擷取目前線程的執行緒慣用 UI 語言。 如需詳細資訊，請參閱使用者介面語言管理。
GetThreadUILanguage 傳回目前線程第一個使用者介面語言的語言識別項。
GetUILanguageInfo 擷取已安裝 UI 語言的各種資訊
GetUserDefaultGeoName 擷取兩個字母的標準化組織 (ISO) 3166-1 程式碼或數值 United The United Organization (UN) Series M，Number 49 (M.49) code for the default 地理位置。
GetUserDefaultLangID 傳回目前使用者 [區域格式] 設定的語言識別項。
GetUserDefaultLCID 傳回使用者預設地區設定的地區設定識別碼。注意 如果使用者預設地區設定是自訂地區設定，應用程式無法以值來正確標記資料或交換資料。
GetUserDefaultLocaleName 擷取使用者預設的地區設定名稱。注意 如果應用程式設計為只在 Windows Vista 和更新版本上執行，則應用程式應該優先呼叫此函式給 GetUserDefaultLCID。
GetUserDefaultUILanguage 傳回目前使用者使用者 UI 語言的語言識別項。
GetUserGeoID 擷取使用者地理位置的相關資訊。 如需詳細資訊，請參閱地理位置資料表。
GetUserPreferredUILanguages 擷取使用者慣用 UI 語言的相關資訊。 如需詳細資訊，請參閱使用者介面語言管理。
IdnToAscii 將國際化功能變數名稱 (IDN) 或其他國際化標籤轉換成 Unicode (寬字元) 表示 ASCII 字串，此字串代表 Punycode 傳輸編碼語法中的名稱。
IdnToNameprepUnicode 將國際化功能變數名稱 (IDN) 或其他國際化標籤轉換成網路工作組 RFC 3491 所指定的 NamePrep 表單，但不會執行其他轉換至 Punycode。
IdnToUnicode 將國際化功能變數名稱的 Punycode 形式， (IDN) 或其他國際化標籤轉換為一般的 Unicode UTF-16 編碼語法。
IS_HIGH_SURROGATE 判斷字元是否為 UTF-16 高 Surrogate 字碼點，範圍從0xd800到包含0xdbff。
IS_LOW_SURROGATE 判斷字元是否為 UTF-16 低 Surrogate 字碼點，範圍從0xdc00到包含0xdfff。
IS_SURROGATE_PAIR 判斷指定的程式碼單位是否形成 UTF-16 Surrogate 配對。
IsDBCSLeadByte 判斷指定的字元是否為系統預設 Windows ANSI 字碼頁的前置位元組 (CP_ACP) 。 前置位元組是字碼頁的雙位元組字元集中雙位元組字元的第一個位元組， (DBCS) 。
IsDBCSLeadByteEx 判斷指定的字元是否可能是前置位元組。 前置位元組是字碼頁的雙位元組字元集中雙位元組字元的第一個位元組， (DBCS) 。
IsNLSDefinedString 判斷字串中的每個字元是否具有指定 NLS 功能的已定義結果。
IsNormalizedString 確認字串是否根據 Unicode 4.0 TR#15 正規化。 如需詳細資訊，請參閱使用 Unicode 正規化來表示字串。
IsValidCodePage 判斷指定的字碼頁是否有效。
IsValidLanguageGroup 判斷作業系統上是否已安裝或支援語言群組。 如需詳細資訊，請參閱 NLS 術語。
IsValidLocale 判斷作業系統上是否已安裝或支援指定的地區設定。 如需詳細資訊，請參閱地區設定和語言。
IsValidLocaleName 判斷指定的地區設定名稱是否適用于作業系統上安裝或支援的地區設定。注意 只在 Windows Vista 和更新版本上執行的應用程式應該以 IsValidLocale 的喜好呼叫此函式，以判斷補充地區設定的有效性。
IsValidNLSVersion 判斷 NLS 版本是否對指定的 NLS 函式有效。
LCIDToLocaleName 將地區設定識別碼轉換為地區設定名稱。
LCMapStringA 針對識別碼所指定的地區設定，使用指定的轉換將一個輸入字元字串對應到另一個輸入字元字串，或產生輸入字串的排序索引鍵。 (ANSI)
LCMapStringEx 針對依名稱指定的地區設定，使用指定的轉換將輸入字元字串對應到另一個地區設定，或產生輸入字串的排序索引鍵。注意 如果應用程式設計為只在 Windows Vista 和更新版本上執行，則應用程式應該以喜好設定呼叫此函式。
LCMapStringW 針對識別碼所指定的地區設定，使用指定的轉換將一個輸入字元字串對應到另一個輸入字元字串，或產生輸入字串的排序索引鍵。 (Unicode)
LoadStringByReference 不支援。 LoadStringByReference 可能會改變或無法使用。 請改用 SHLoadIndirectString。
LocaleNameToLCID 將地區設定名稱轉換為地區設定識別碼。
NormalizeString 根據 Unicode 4.0 TR#15 正規化文字字串的字元。 如需詳細資訊，請參閱使用 Unicode 正規化來表示字串。
NotifyUILanguageChange 不支援。 NotifyUILanguageChange 可能會改變或無法使用。
ResolveLocaleName 尋找所提供名稱的可能地區設定名稱相符。
SetCalendarInfoA 設定行事曆的地區設定資訊專案。 如需詳細資訊，請參閱日期與行事曆。 (ANSI)
SetCalendarInfoW 設定行事曆的地區設定資訊專案。 如需詳細資訊，請參閱日期與行事曆。 (Unicode)
SetLocaleInfoA 設定使用者覆寫目前地區設定部分的資訊專案。 此函式不會設定系統預設值。 (ANSI)
SetLocaleInfoW 設定使用者覆寫目前地區設定部分的資訊專案。 此函式不會設定系統預設值。 (Unicode)
SetProcessPreferredUILanguages 設定應用程式進程的慣用 UI 語言。 如需詳細資訊，請參閱使用者介面語言管理。
SetThreadLocale 設定呼叫執行緒的目前地區設定。
SetThreadPreferredUILanguages 設定目前線程的執行緒慣用 UI 語言。 如需詳細資訊，請參閱使用者介面語言管理。
SetThreadUILanguage 設定目前線程的使用者介面語言。
SetUserGeoID 設定使用者的地理位置識別碼。 此識別碼應具有地理位置資料表中所述的其中一個值。
SetUserGeoName 將目前使用者的地理位置設定為指定的兩個字母國際標準組織 (ISO) 3166-1 程式碼或數值 United Organization (UN) Series M，Number 49 (M.49) code。
VerifyScripts 比較兩個列舉的腳本清單。

回呼函式

GEO_ENUMNAMEPROC 應用程式定義的回呼函式，可處理 EnumSystemGeoNames 函式所提供的列舉地理位置資訊。
LANGGROUPLOCALE_ENUMPROCA 應用程式定義的回呼函式，可處理 EnumLanguageGroupLocales 函式所提供的列舉語言群組地區設定資訊。 (ANSI)
LANGGROUPLOCALE_ENUMPROCW 應用程式定義的回呼函式，可處理 EnumLanguageGroupLocales 函式所提供的列舉語言群組地區設定資訊。 (Unicode)
LOCALE_ENUMPROCEX 應用程式定義的回呼函式，可處理 EnumSystemLocalesEx 函式所提供的列舉地區設定資訊。
UILANGUAGE_ENUMPROCA 應用程式定義的回呼函式，可處理 EnumUILanguages 函式所提供的列舉使用者介面語言資訊。 (ANSI)
UILANGUAGE_ENUMPROCW 應用程式定義的回呼函式，可處理 EnumUILanguages 函式所提供的列舉使用者介面語言資訊。 (Unicode)

結構

CPINFO 包含字碼頁的相關資訊。 GetCPInfo 函式會使用此結構。
CPINFOEXA 包含字碼頁的相關資訊。 GetCPInfoEx 函式會使用此結構。 (ANSI)
CPINFOEXW 包含字碼頁的相關資訊。 GetCPInfoEx 函式會使用此結構。 (Unicode)
CURRENCYFMTA 包含定義貨幣字串格式的資訊。 GetCurrencyFormat 函式會使用此資訊來自訂指定地區設定的貨幣字串。 (ANSI)
CURRENCYFMTW 包含定義貨幣字串格式的資訊。 GetCurrencyFormat 函式會使用此資訊來自訂指定地區設定的貨幣字串。 (Unicode)
FILEMUIINFO 包含檔案的相關資訊，與 MUI 搭配使用相關。
NLSVERSIONINFO nLSVERSIONINFO 結構 (winnls.h) 已被取代，不應使用。
NLSVERSIONINFOEX 包含 NLS 功能的版本資訊。
NUMBERFMTA 包含定義數位字串格式的資訊。 GetNumberFormat 函式會使用此資訊來自訂指定地區設定的數位字串。 (ANSI)
NUMBERFMTW 包含定義數位字串格式的資訊。 GetNumberFormat 函式會使用此資訊來自訂指定地區設定的數位字串。 (Unicode)

列舉

NORM_FORM 指定支援的正規化形式。
SYSGEOCLASS 指定地理位置類別。
SYSGEOTYPE 定義 GetGeoInfo 或 GetGeoInfoEx 函式中要求的地理位置資訊類型。
SYSNLS_FUNCTION 指定 NLS 函式功能。