LocaleNameToLCID 函式 (winnls.h)

將地區設定 名稱轉換為地區 設定 識別碼。

語法

LCID LocaleNameToLCID(
  [in] LPCWSTR lpName,
  [in] DWORD   dwFlags
);

參數

[in] lpName

代表地區設定名稱的 Null 終止字串指標，或下列其中一個預先定義的值。

• LOCALE_NAME_INVARIANT
• LOCALE_NAME_SYSTEM_DEFAULT
• LOCALE_NAME_USER_DEFAULT

[in] dwFlags

在 Windows 7 之前：保留;應該一律為 0。

從 Windows 7 開始： 可以設定為 LOCALE_ALLOW_NEUTRAL_NAMES ，以允許傳回中性 LCID。

傳回值

如果成功，則會傳回對應至地區設定名稱的地區設定標識符。

如果提供的地區設定名稱對應至用戶預設的自定義地區設定，則此函式會傳回 LOCALE_CUSTOM_DEFAULT。

如果地區設定名稱對應至不是用戶預設值的自定義地區設定、是暫時性地區設定，或是 CLDR (Unicode Common Locale Data Repository) 地區設定，則函式會傳回 LOCALE_CUSTOM_UNSPECIFIED。

如果函式未成功，則傳回 0。 若要取得延伸的錯誤資訊，應用程式可以呼叫 GetLastError，如果有任何參數值無效，則可以傳回ERROR_INVALID_PARAMETER。

備註

針對自定義地區設定，包括 Microsoft 所建立的地區設定，您的應用程式應該偏好地區設定名稱而非地區設定標識符。 如需詳細資訊，請參閱取代 LCID 。

從 Windows 8 開始：如果您的 app 從 Windows.Globalization 命名空間將語言標記傳遞至此函式，則必須先呼叫 ResolveLocaleName 來轉換標記。

範例

#include "stdafx.h"
#include "windows.h"
#include "stdio.h"

int _cdecl main(
    int argc,
    char *argv[])
{
    WCHAR strNameBuffer[LOCALE_NAME_MAX_LENGTH];
    DWORD error = ERROR_SUCCESS;
    LCID  lcid;

    // Get the name for locale 0x10407 (German (German), with phonebook sort)
    if (LCIDToLocaleName(0x10407, strNameBuffer, LOCALE_NAME_MAX_LENGTH, 0) == 0)
    {
        // There was an error
        error = GetLastError();
    }
    else
    {
        // Success, display the locale name we found
        wprintf(L"Locale Name for 0x10407 is %s\n", strNameBuffer);
    }

    // Get the LCID for the locale
    lcid = LocaleNameToLCID(strNameBuffer, 0);
    if (lcid == 0)
    {
        // There was an error
        error = GetLastError();
    }
    else
    {
        // Success, print the round trip LCID
        wprintf(L"LCID for %s is 0x%x\n", strNameBuffer, lcid);
    }
}

/* This code example produces the following output:

Locale Name for 0x10407 is de-DE_phoneb
LCID for de-DE_phoneb is 0x10407

*/

規格需求

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

另請參閱

DownlevelLocaleNameToLCID

NLS：名稱型 API 範例

國家語言支援

國家語言支援函式