ResolveLocaleName 函式 (winnls.h)

尋找所提供名稱的可能 地區設定名稱 相符專案。

語法

int ResolveLocaleName(
  [in, optional]  LPCWSTR lpNameToResolve,
  [out, optional] LPWSTR  lpLocaleName,
  [in]            int     cchLocaleName
);

參數

[in, optional] lpNameToResolve

要解析之名稱的指標,例如,英文的 「en-XA」 (Private Use) 。

[out, optional] lpLocaleName

緩衝區的指標,此函式會擷取符合輸入名稱的地區設定名稱。 例如,名稱 「en-XA」 的相符專案是英文 (美國) 的 「en-US」。

注意 如果函式失敗,則輸出緩衝區的狀態不保證正確。 在此情況下,應用程式應該檢查函式所設定的傳回值和錯誤狀態,以判斷正確的動作程式。
 

[in] cchLocaleName

大小,以字元為單位,以字元為單位,以 lpLocaleName表示的緩衝區。 地區設定名稱的可能長度上限,包括終止的 Null 字元是 LOCALE_NAME_MAX_LENGTH的值。 這是在此參數中提供的建議大小。

傳回值

如果成功,會傳回包含地區設定名稱的緩衝區大小,包括終止的 Null 字元。

如果函式不成功,函式會傳回 0。 若要取得擴充的錯誤資訊,應用程式可以呼叫 GetLastError,這可以傳回下列其中一個錯誤碼:

  • ERROR_INSUFFICIENT_BUFFER。 提供的緩衝區大小不夠大,或設定為 Null不正確。

備註

擷取的地區設定名稱表示特定的地區設定,包括語言和國家/地區,即使輸入語言是中性語言也一樣。 例如,英文 (美國) 的 「en」 輸入會導致函式擷取 「en-US」。

此函式可以從 自訂地區設定擷取資料。 資料不保證從電腦到電腦或在應用程式執行之間相同,也不會傳回有效的地區設定保證在另一部電腦上有效。 如果您的應用程式必須保存或傳輸資料,請參閱 使用持續性地區設定資料

從 Windows 8 開始:Windows.Globalization 命名空間取得的語言標記必須先由 ResolveLocaleName 轉換,才能搭配任何國家語言支援函式使用。

規格需求

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

另請參閱

國家語言支援

國家語言支援函式

Windows.Globalization