Partilhar via


Método IHostTaskManager::SetLocale

Notifica o anfitrião de que o runtime de linguagem comum (CLR) alterou a região ou a cultura na tarefa atualmente em execução.

Sintaxe

HRESULT SetLocale (  
    [in] LCID lcid  
);  

Parâmetros

lcid
[in] O valor do identificador de região que mapeia para a cultura geográfica e a linguagem recentemente atribuídas.

Devolver Valor

HRESULT Description
S_OK SetLocale devolvido com êxito.
HOST_E_CLRNOTAVAILABLE O CLR não foi carregado para um processo ou o CLR está num estado em que não pode executar código gerido ou processar a chamada com êxito.
HOST_E_TIMEOUT A chamada excedeu o limite de tempo.
HOST_E_NOT_OWNER O autor da chamada não é o proprietário do bloqueio.
HOST_E_ABANDONED Um evento foi cancelado enquanto um thread ou fibra bloqueado estava à espera do mesmo.
E_FAIL Ocorreu uma falha catastrófica desconhecida. Quando um método devolve E_FAIL, o CLR já não é utilizável no processo. As chamadas subsequentes para métodos de alojamento devolvem HOST_E_CLRNOTAVAILABLE.
E_NOTIMPL O anfitrião não permite que o código de utilizador gerido modifique a região.

Observações

O runtime chama SetLocale quando o valor da Thread.CurrentCulture propriedade é alterado pelo código gerido. Este método proporciona uma oportunidade para o anfitrião executar quaisquer mecanismos que possa ter para sincronização de regiões. Se um anfitrião não permitir que a região seja alterada do código gerido ou não implementar um mecanismo para sincronizar regiões, deverá devolver E_NOTIMPL deste método.

Requisitos

Plataformas: Veja Requisitos do Sistema.

Cabeçalho: MSCorEE.h

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

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

Ver também