Bagikan melalui

Metode IHostIoCompletionManager::GetHostOverlappedSize

Mendapatkan ukuran data kustom apa pun yang ingin ditambahkan host ke permintaan I/O.

Sintaks

HRESULT GetHostOverlappedSize (  
    [out] DWORD *pcbSize  
);

Parameter

pcbSize
[out] Penunjuk ke jumlah byte yang harus dialokasikan oleh runtime bahasa umum (CLR) selain ukuran objek OVERLAPPED Win32.

Tampilkan Nilai

HRESULT Deskripsi
S_OK GetHostOverlappedSize 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.

Keterangan

Semua panggilan I/O asinkron ke API Platform Windows mengambil objek OVERLAPPED Win32, yang menyediakan informasi seperti posisi penunjuk file. Untuk mempertahankan status, aplikasi yang membuat panggilan I/O asinkron biasanya menambahkan data kustom ke struktur. GetHostOverlappedSize dan IHostIoCompletionManager::InitializeHostOverlapped memberikan kesempatan bagi host untuk menyertakan data kustom tersebut.

Runtime bahasa umum memanggil metode GetHostOverlappedSize untuk menentukan ukuran data kustom yang ingin ditambahkan host ke objek OVERLAPPED.

Catatan

GetHostOverlappedSize hanya dipanggil sekali. Data kustom host harus berukuran sama untuk setiap permintaan I/O.

Penting

Ukuran objek OVERLAPPED itu sendiri tidak termasuk dalam nilai pcbSize.

Untuk informasi selengkapnya tentang struktur OVERLAPPED, lihat dokumentasi platform Windows.

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