Aracılığıyla paylaş


ICLRTaskManager::CreateTask Yöntemi

Ortak dil çalışma zamanının (CLR) yeni bir görev oluşturmasını açıkça ister.

Sözdizimi

HRESULT CreateTask (  
    [out] ICLRTask **pTask  
);  

Parametreler

pTask
[out] Yeni oluşturulan bir ICLRTask adresinin işaretçisi veya görev oluşturulamadıysa null.

Dönüş Değeri

HRESULT Description
S_OK Yöntem başarıyla döndürüldü.
HOST_E_CLRNOTAVAILABLE CLR bir işleme yüklenmedi veya CLR yönetilen kodu çalıştıramadığı veya çağrıyı başarıyla işleyemediği bir durumda.
HOST_E_TIMEOUT Arama zaman aşımına uğradı.
HOST_E_NOT_OWNER Çağıranın kilidi yoktur.
HOST_E_ABANDONED Engellenen bir iş parçacığı veya fiber beklerken bir olay iptal edildi.
E_FAIL Bilinmeyen bir yıkıcı hata oluştu. Bir yöntem E_FAIL döndürdüğünde, CLR artık işlem içinde kullanılamaz. Barındırma yöntemlerine yapılan sonraki çağrılar HOST_E_CLRNOTAVAILABLE döndürür.
E_OUTOFMEMORY İstenen kaynağı ayırmak için yeterli bellek yok.

Açıklamalar

ClR, kullanıcı kodu ad alanında türleri kullanarak bir iş parçacığı oluşturduğunda System.Threading veya iş parçacığı havuzunun boyutu artırıldığında, başlatmadan sonra otomatik olarak yeni bir görev oluşturur. Yönetilmeyen kod yönetilen bir işleve çağrı yaptığında da görevler oluşturur.

CreateTask konağın CLR'nin yeni bir görev oluşturması için açık bir istekte bulunmasını sağlar. Örneğin, konak veri yapılarını önceden başlatmak için bu yöntemi çağırabilir.

Önemli

Yeni görev askıya alınmış durumda döndürülür ve konak IHostTask::Start'ı açıkça çağırana kadar askıya alınmış durumda kalır.

Gereksinimler

Platform: Bkz. Sistem Gereksinimleri.

Üstbilgi: MSCorEE.h

Kitaplığı: MSCorEE.dll'da kaynak olarak dahil edilen

.NET Framework Sürümleri: 2.0 sürümünden itibaren kullanılabilir

Ayrıca bkz.