共用方式為


getNLSVersion 函式 (winnls.h)

擷取識別碼所指定地區設定之目前版本的指定 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

另請參閱

GetNLSVersionEx

處理應用程式中的排序

NLSVERSIONINFO

NLSVERSIONINFOEX

國家語言支援

國家語言支援函式

SYSNLS_FUNCTION