ICLRTaskManager

[アーティクル]
09/17/2008

更新 : 2007 年 11 月

ホストが、共通言語ランタイム (CLR: Common Language Runtime) による新しいタスクの作成を明示的に要求したり、現在の実行タスクを取得したり、タスクの地理的な言語およびカルチャを設定したりできるメソッドを提供します。

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

メソッド

メソッド	説明
ICLRTaskManager::CreateTask メソッド	新しい ICLRTask インスタンスの作成を CLR に明示的に要求します。
ICLRTaskManager::GetCurrentTask メソッド	現在実行しているタスクを表す ICLRTask インスタンスを取得します。
ICLRTaskManager::GetCurrentTaskType メソッド	現在実行中のタスクの種類を取得します。
ICLRTaskManager::SetLocale メソッド	現在実行されているタスクでホストがロケール識別子を変更したことを CLR に通知します。
ICLRTaskManager::SetUILocale メソッド	現在実行されているタスクでホストがユーザーインターフェイスのロケール識別子を変更したことを共通言語ランタイムに通知します。

解説

ホストされる環境で実行している各タスクは、ホスト側の表現 (IHostTask のインスタンス) と、CLR 側の表現 (ICLRTask のインスタンス) を持っています。ホストと CLR のどちらでもタスクの作成を開始できますが、タスクに関するホストと CLR 間の通信を成功させるには、ホスト側の表現が、対応する CLR 側の表現と関連付けられている必要があります。マネージコードをオペレーティングシステムスレッドで実行できるようにするには、その前に 2 つのオブジェクトを作成しインスタンス化しておく必要があります。