Bagikan melalui

Metode ICLRTaskManager::CreateTask

Permintaan secara eksplisit bahwa runtime bahasa umum (CLR) membuat tugas baru.

Sintaks

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

Parameter

pTask
[out] Penunjuk ke alamat ICLRTask yang baru dibuat, atau null, jika tugas tidak dapat dibuat.

Tampilkan Nilai

HRESULT Deskripsi
S_OK Metode berhasil dikembalikan.
HOST_E_CLRNOTAVAILABLE Runtime bahasa umum belum dimuat ke dalam proses, atau runtime bahasa umum dalam status yaitu tidak dapat menjalankan kode aman atau memproses panggilan dengan sukses.
HOST_E_TIMEOUT Waktu panggilan habis.
HOST_E_NOT_OWNER Pemanggil tidak memiliki kunci.
HOST_E_ABANDONED Peristiwa dibatalkan saat rangkaian atau fiber yang diblokir sedang menunggunya.
E_FAIL Kegagalan katastrofe yang tidak diketahui terjadi. Saat metode menampilkan E_FAIL, CLR tidak lagi dapat digunakan dalam proses. Panggilan berikutnya ke metode hosting menampilkan HOST_E_CLRNOTAVAILABLE.
E_OUTOFMEMORY Tidak tersedia cukup memori untuk mengalokasikan sumber daya yang diminta.

Keterangan

CLR membuat tugas baru secara otomatis setelah inisialisasi, ketika kode pengguna membuat utas dengan menggunakan jenis di namespace layanan System.Threading, atau ketika ukuran kumpulan utas ditingkatkan. Ini juga membuat tugas ketika kode yang tak terkelola melakukan panggilan ke fungsi terkelola.

CreateTask memungkinkan host membuat permintaan eksplisit bahwa CLR membuat tugas baru. Misalnya, host dapat memanggil metode ini untuk melakukan prainisialisasi struktur data.

Penting

Tugas baru dikembalikan dalam status ditangguhkan dan tetap ditangguhkan sampai host secara eksplisit memanggil IHostTask::Start.

Persyaratan

Platform: Lihat Persyaratan Sistem.

Header: MSCorEE.h

Pustaka: Disertakan sebagai sumber daya di MSCorEE.dll

Versi .NET Framework: Tersedia mulai dari 2.0

Lihat juga

  • Last updated on