Metode IHostThreadPoolManager::QueueUserWorkItem

Mengantrekan fungsi untuk eksekusi, dan menentukan objek yang berisi data yang akan digunakan oleh fungsi tersebut. Fungsi dijalankan ketika utas tersedia.

Sintaksis

HRESULT QueueUserWorkItem (
    [in] LPTHREAD_START_ROUTINE Function,
    [in] PVOID Context,
    [in] ULONG Flags
);

Parameter-parameternya

Function [di] Penunjuk fungsi yang mewakili fungsi yang akan dijalankan.

Context [di] Objek yang berisi data yang akan digunakan oleh Function.

Flags [di] Salah satu nilai bendera, seperti yang didefinisikan untuk metode Win32 QueueUserWorkItem , yang mengontrol eksekusi.

Mengembalikan Nilai

HRESULT Deskripsi
S_OK QueueUserWorkItem berhasil dikembalikan.
HOST_E_CLRNOTAVAILABLE Runtime bahasa umum (CLR) belum dimuat ke dalam proses, atau CLR berada dalam keadaan di mana ia tidak dapat menjalankan kode terkelola 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 utas atau serat yang diblokir sedang menunggu di atasnya.
E_FAIL Kegagalan bencana yang tidak diketahui terjadi. Ketika metode mengembalikan E_FAIL, CLR tidak lagi dapat digunakan dalam proses. Panggilan berikutnya ke metode hosting mengembalikan HOST_E_CLRNOTAVAILABLE.

Komentar

QueueUserWorkItem mengantrekan item kerja ke utas pekerja di kumpulan utas. Jenis tanda tangan dan parameternya identik dengan fungsi Win32 yang sesuai, yang memiliki nama yang sama. Untuk informasi selengkapnya, lihat dokumentasi Platform Windows.

Persyaratan

Platform: Lihat Persyaratan Sistem.

Header: MSCorEE.h

Perpustakaan: Disertakan sebagai sumber daya dalam MSCorEE.dll

Versi .NET Framework: Tersedia sejak 2.0

Baca juga