ICLRTaskManager-Schnittstelle

Artikel
09/02/2008

Aktualisiert: November 2007

Stellt Methoden bereit, mit denen es dem Host möglich ist, die momentan ausgeführte Aufgabe abzurufen, die geografische Sprache und Kultur für die Aufgabe festzulegen und die Common Language Runtime (CLR) ausdrücklich anzuweisen, eine neue Aufgabe zu erstellen.

interface ICLRTaskManager : IUnknown {
    HRESULT CreateTask (
        [out] ICLRTask **pTask
    );
    HRESULT GetCurrentTask (
        [out] ICLRTask **ppTask
    );
    HRESULT SetUILocale (
        [in] LCID lcid
    );
    HRESULT SetLocale (
        [in] LCID lcid
    );
};

Methoden

Methode	Beschreibung
ICLRTaskManager::CreateTask-Methode	Weist die CLR explizit an, eine neue ICLRTask-Instanz zu erstellen.
ICLRTaskManager::GetCurrentTask-Methode	Ruft die ICLRTask-Instanz ab, die die Aufgabe darstellt, die gerade ausgeführt wird.
ICLRTaskManager::GetCurrentTaskType-Methode	Ruft den Typ der Aufgabe ab, die gerade ausgeführt wird.
ICLRTaskManager::SetLocale-Methode	Benachrichtigt die CLR, dass der Host den Gebietsschemabezeichner für die aktuell ausgeführte Aufgabe geändert hat.
ICLRTaskManager::SetUILocale-Methode	Benachrichtigt die Common Language Runtime, dass der Host den Gebietsschemabezeichner der Benutzeroberfläche für die aktuell ausgeführte Aufgabe geändert hat.

Hinweise

Jede Aufgabe, die in einer gehosteten Umgebung ausgeführt wird, verfügt über Darstellungen auf der Hostseite (eine Instanz von IHostTask) und auf der CLR-Seite (eine Instanz von ICLRTask). Host oder CLR können die Erstellung einer Aufgabe initiieren, allerdings muss die hostseitige Darstellung einer entsprechenden Darstellung auf der CLR-Seite zugeordnet sein, damit die Kommunikation zwischen Host und CLR in Bezug auf die Aufgabe richtig funktioniert. Die beiden Objekte müssen erstellt und instanziiert werden, bevor verwalteter Code auf einem Betriebssystemthread ausgeführt werden kann.