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 |