Bagikan melalui


Metode IHostTaskManager::CreateTask

Meminta agar host membuat tugas baru.

Sintaks

HRESULT CreateTask (  
    [in]  DWORD stacksize,
    [in]  LPTHREAD_START_ROUTINE pStartAddress,  
    [in]  PVOID pParameter,  
    [out] IHostTask **ppTask  
);  

Parameter

stacksize
[in] Ukuran yang dipesan dari tumpukan yang diminta atau 0 (nol) untuk ukuran default dalam byte.

pStartAddress
[in] Penunjuk ke fungsi yang akan dijalankan oleh tugas.

pParameter
[in] Penunjuk ke data pengguna yang akan diteruskan ke fungsi atau null jika fungsi tidak menggunakan parameter.

ppTask
[out] Penunjuk ke alamat instans IHostTask yang dibuat oleh host atau null jika tugas tidak dapat dibuat. Tugas tetap dalam status ditangguhkan sampai secara eksplisit dimulai oleh panggilan ke IHostTask::Start.

Tampilkan Nilai

HRESULT Deskripsi
S_OK CreateTask berhasil dikembalikan.
HOST_E_CLRNOTAVAILABLE Runtime bahasa umum (CLR) belum dimuat ke dalam proses, atau CLR berada dalam status yang tidak dapat menjalankan kode terkelola atau tidak berhasil memproses panggilan.
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 Memori yang tersedia tidak cukup untuk membuat tugas yang diminta.

Keterangan

CLR memanggil CreateTask untuk meminta host membuat tugas baru. Host mengembalikan penunjuk antarmuka ke instans IHostTask. Tugas yang dikembalikan harus tetap ditangguhkan sampai secara eksplisit dimulai oleh panggilan ke 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