Compartilhar via


Método IHostTaskManager::SetUILocale

Notifica o host de que o CLR (Common Language Runtime) alterou a localidade ou a cultura da interface do usuário na tarefa em execução no momento.

Sintaxe

HRESULT SetUILocale (
    [in] LCID lcid
);

Parâmetros

lcid [in] O valor do identificador de localidade que é mapeado para a cultura geográfica e a linguagem recém-atribuídas.

Valor de retorno

HRESULT Descrição
S_OK SetUILocale retornado com êxito.
HOST_E_CLRNOTAVAILABLE O CLR não foi carregado em um processo ou o CLR está em um estado no qual não pode executar o código gerenciado ou processar a chamada com êxito.
HOST_E_TIMEOUT A chamada atingiu o tempo limite.
HOST_E_NOT_OWNER O chamador não possui o bloqueio.
HOST_E_ABANDONED Um evento foi cancelado enquanto um thread ou fibra bloqueado estava esperando por ele.
E_FAIL Ocorreu uma falha catastrófica desconhecida. Quando um método retorna E_FAIL, o CLR não é mais utilizável dentro do processo. Chamadas subsequentes para métodos de hospedagem retornam HOST_E_CLRNOTAVAILABLE.
E_NOTIMPL O host não permite que o código do usuário gerenciado altere a cultura da interface do usuário.

Observações

O runtime chama SetUILocale quando o valor da Thread.CurrentUICulture propriedade é alterado pelo código gerenciado. Esse método oferece uma oportunidade para o host executar quaisquer mecanismos que possa ter para sincronização de localidades. Se um host não permitir que a localidade da interface do usuário seja alterada do código gerenciado ou não implemente um mecanismo para sincronizar localidades, ele deverá retornar E_NOTIMPL desse método.

Requisitos

Plataformas: confira Requisitos do sistema.

Cabeçalho: MSCorEE.h

Biblioteca: Incluído como um recurso no MSCorEE.dll

Versões do .NET Framework: Disponível desde 2.0

Consulte também