IHostTaskManager::SetUILocale-Methode
Benachrichtigt den Host, dass die Common Language Runtime (CLR) das Gebietsschema oder die Kultur der Benutzeroberfläche (UI) für die aktuell ausgeführte Aufgabe geändert hat.
Syntax
HRESULT SetUILocale (
[in] LCID lcid
);
Parameter
lcid
[in] Der Gebietsschemabezeichnerwert, der der neu zugewiesenen geografischen Kultur und Sprache zugeordnet ist.
Rückgabewert
HRESULT | BESCHREIBUNG |
---|---|
S_OK | SetUILocale wurde erfolgreich zurückgegeben. |
HOST_E_CLRNOTAVAILABLE | Die CLR wurde nicht in einen Prozess geladen, oder die CLR befindet sich in einem Zustand, in dem sie keinen verwalteten Code ausführen oder den Aufruf nicht erfolgreich verarbeiten kann. |
HOST_E_TIMEOUT | Timeout des Aufrufs. |
HOST_E_NOT_OWNER | Der Aufrufer besitzt die Sperre nicht. |
HOST_E_ABANDONED | Ein Ereignis wurde abgebrochen, während ein blockierter Thread oder eine blockierte Fiber darauf gewartet hat. |
E_FAIL | Es ist ein unbekannter katastrophaler Fehler aufgetreten. Wenn eine Methode E_FAIL zurückgibt, kann die CLR nicht mehr innerhalb des Prozesses verwendet werden. Nachfolgende Aufrufe von Hostingmethoden geben HOST_E_CLRNOTAVAILABLE zurück. |
E_NOTIMPL | Der Host lässt nicht zu, dass verwalteter Benutzercode die UI-Kultur ändert. |
Bemerkungen
Die Runtime wird aufgerufen SetUILocale
, wenn der Wert der Thread.CurrentUICulture Eigenschaft durch verwalteten Code geändert wird. Diese Methode bietet dem Host die Möglichkeit, alle Mechanismen auszuführen, die für die Synchronisierung von Gebietsschemas vorhanden sein könnten. Wenn ein Host nicht zulässt, dass das UI-Gebietsschema von verwaltetem Code geändert wird oder keinen Mechanismus zum Synchronisieren von Gebietsschemas implementiert, sollte er E_NOTIMPL von dieser Methode zurückgeben.
Anforderungen
Plattformen: Informationen finden Sie unter Systemanforderungen.
Header: MSCorEE.h
Bibliothek: Als Ressource in „MsCorEE.dll“ enthalten.
.NET Framework-Versionen: Seit 2.0 verfügbar.