Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
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