IHostTaskManager::SetUILocale-Methode

Artikel
08/20/2008

Aktualisiert: November 2007

Benachrichtigt den Host, dass die Common Language Runtime (CLR) das Gebietsschema oder die Kultur der Benutzeroberfläche für die aktuell ausgeführte Aufgabe geändert hat.

HRESULT SetUILocale (
    [in] LCID lcid
);

Parameter

lcid
[in] Der Bezeichnerwert des Gebietsschemas, der auf die neu zugeordnete geografische Kultur und Sprache verweist.

Rückgabewert

HRESULT	Beschreibung
S_OK	SetUILocale wurde erfolgreich zurückgegeben.
HOST_E_CLRNOTAVAILABLE	Die CLR wurde nicht in einen Prozess geladen oder befindet sich in einem Zustand, in dem sie weder verwalteten Code ausführen noch den Aufruf erfolgreich verarbeiten kann.
HOST_E_TIMEOUT	Das Zeitlimit für den Aufruf wurde überschritten.
HOST_E_NOT_OWNER	Der Aufrufer ist nicht Besitzer der Sperre.
HOST_E_ABANDONED	Ein Ereignis wurde abgebrochen, während ein blockierter Thread oder eine blockierte Fiber auf das Ereignis gewartet hat.
E_FAIL	Ein unbekannter, schwerwiegender Fehler ist aufgetreten. Wenn eine Methode E_FAIL zurückgibt, kann die CLR innerhalb des Prozesses nicht mehr verwendet werden. Nachfolgende Aufrufe von Hostmethoden geben HOST_E_CLRNOTAVAILABLE zurück.
E_NOTIMPL	Der Host lässt nicht zu, dass die UI-Kultur durch verwalteten Benutzercode geändert wird.

Hinweise

Die Laufzeit ruft SetUILocale auf, wenn der Wert der Thread.CurrentUICulture-Eigenschaft von verwaltetem Code geändert wurde. Diese Methode stellt eine Möglichkeit für den Host bereit, jeden seiner Mechanismen zur Synchronisierung von Gebietsschemas auszuführen. Wenn ein Host eine Änderung des Gebietsschemas durch verwalteten Code nicht zulässt oder keinen Mechanismus zur Synchronisierung von Gebietsschemas implementiert, muss er E_NOTIMPL für diese Methode zurückgeben.