Função SetThreadLocale (winnls.h)

Artigo
08/27/2023

Define a localidade atual do thread de chamada.

Sintaxe

BOOL SetThreadLocale(
  [in] LCID Locale
);

Parâmetros

[in] Locale

Identificador de localidade que especifica a localidade. Você pode usar a macro MAKELCID para criar um identificador de localidade ou usar um dos valores predefinidos a seguir.

Valor retornado

A função deve retornar um LCID em caso de êxito. Esse é o LCID da localidade do thread anterior.

Comentários

Quando um thread é criado, ele usa a localidade do usuário. Esse valor é retornado por GetUserDefaultLCID. A localidade do usuário pode ser modificada para processos futuros e criação de threads usando a parte de opções regionais e de idioma do Painel de Controle. A localidade do thread também pode ser alterada usando SetThreadLocale.

SetThreadLocale afeta a seleção de recursos com uma instrução LANGUAGE . A instrução afeta funções como CreateDialog, DialogBox, LoadMenu, LoadString e FindResource. Ele define a página de código implícita por CP_THREAD_ACP, mas não afeta FindResourceEx. Para obter mais informações, consulte Identificadores de página de código.

Windows Vista e posterior: Não use SetThreadLocale para selecionar um idioma de interface do usuário. O carregador de recursos seleciona o recurso definido no arquivo .rc com uma instrução LANGUAGE ou o aplicativo pode usar FindResourceEx. Além disso, o aplicativo pode usar SetThreadUILanguage.

Windows 2000, Windows XP: Não use SetThreadLocale para selecionar um idioma de interface do usuário. Para selecionar o recurso definido no arquivo .rc com uma instrução LANGUAGE , o aplicativo deve usar a função FindResourceEx .

Requisitos


Cliente mínimo com suporte	Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	winnls.h (inclua Windows.h)
Biblioteca	Kernel32.lib
DLL	Kernel32.dll