getNLSVersion 函式 (winnls.h)

發行項
08/27/2023

擷取識別碼所指定地區設定之目前版本的指定 NLS 功能相關資訊。

注意基於互通性考慮，應用程式應該偏好 GetNLSVersionEx 函式至 GetNLSVersion ，因為 Microsoft 正移轉至使用地區設定名稱，而不是新地區設定的地區設定識別碼。這項建議特別適用于自訂地區設定，其中 GetNLSVersionEx 會擷取足夠的資訊，以判斷排序行為是否已變更。只有在 Windows Vista 和更新版本上執行的任何應用程式都應該使用GetNLSVersionEx，或至少在呼叫GetNLSVersion以取得其他排序版本設定資料時傳遞NLSVERSIONINFOEX結構。

語法

BOOL GetNLSVersion(
  [in]      NLS_FUNCTION     Function,
  [in]      LCID             Locale,
  [in, out] LPNLSVERSIONINFO lpVersionInformation
);

參數

[in] Function

要查詢的 NLS 功能。此值必須COMPARE_STRING。請參閱 SYSNLS_FUNCTION 列舉。

[in] Locale

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

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

[in, out] lpVersionInformation

NLSVERSIONINFO結構的指標。應用程式必須將 dwNLSVersionInfoSize 成員初始化為 sizeof(NLSVERSIONINFO) 。

注意在 Windows Vista 和更新版本上，函式也可以提供 NLSVERSIONINFOEX 結構中的版本資訊。

傳回值

只有在應用程式已在lpVersionInformation中提供有效值，否則會傳回TRUE，否則傳回FALSE。若要取得擴充的錯誤資訊，應用程式可以呼叫 GetLastError，這可以傳回下列其中一個錯誤碼：

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

備註

此函式可讓 Active Directory 之類的應用程式判斷 NLS 變更是否會影響特定索引資料表所使用的地區設定識別碼。如果沒有，就不需要重新編制資料表的索引。如需詳細資訊，請參閱處理應用程式中的排序。

規格需求


最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]
目標平台	Windows
標頭	winnls.h (包含 Windows.h)
程式庫	Kernel32.lib
DLL	Kernel32.dll