Bagikan melalui

IHostIoCompletionManager::InitializeHostOverlapped Method

Memberi tuan rumah kesempatan untuk menginisialisasi data kustom apa pun untuk ditambahkan ke struktur OVERLAPPED Win32 yang digunakan untuk permintaan I/O asinkron.

Sintaks

HRESULT InitializeHostOverlapped (  
    [in] void* pvOverlapped  
);

Parameter

pvOverlapped
[in] Penunjuk ke struktur Win32 OVERLAPPED untuk disertakan dengan permintaan I/O.

Tampilkan Nilai

HRESULT Deskripsi
S_OK InitializeHostOverlapped 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 mengalokasikan sumber daya yang diminta.

Keterangan

Fungsi platform Windows menggunakan struktur OVERLAPPED untuk menyimpan status untuk permintaan I/O asinkron. Runtime bahasa umum memanggil metode InitializeHostOverlapped untuk memberikan kesempatan kepada tuan rumah untuk menambahkan data kustom ke instans OVERLAPPED.

Penting

Untuk memulai blok data khusus mereka, host harus mengatur offset ke ukuran struktur OVERLAPPED (sizeof(OVERLAPPED)).

Nilai pengembalian E_OUTOFMEMORY menunjukkan bahwa host telah gagal untuk menginisialisasi data kustomnya. Dalam hal ini, runtime bahasa umum melaporkan kesalahan dan gagal dalam panggilan.

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