Freigeben über

IHostTaskManager::SetLocale-Methode

  • Artikel

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

Syntax

HRESULT SetLocale (  
    [in] LCID lcid  
);

Parameter

lcid
[in] Der Gebietsschemabezeichnerwert, der der neu zugewiesenen geografischen Kultur und Sprache zugeordnet ist.

Rückgabewert

HRESULT BESCHREIBUNG
S_OK SetLocale 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 das Gebietsschema ändert.

Bemerkungen

Die Runtime wird aufgerufen SetLocale , wenn der Wert der Thread.CurrentCulture 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 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.

Siehe auch