Metode ILockBytes::ReadAt (objidl.h)

Metode ReadAt membaca jumlah byte tertentu yang dimulai dari offset tertentu dari awal objek array byte.

Sintaks

HRESULT ReadAt(
  [in]  ULARGE_INTEGER ulOffset,
  [in]  void           *pv,
  [in]  ULONG          cb,
  [out] ULONG          *pcbRead
);

Parameter

[in] ulOffset

Menentukan titik awal dari awal array byte untuk membaca data.

[in] pv

Penunjuk ke buffer tempat array byte dibaca. Ukuran buffer ini terkandung dalam cb.

[in] cb

Menentukan jumlah byte data untuk mencoba membaca dari array byte.

[out] pcbRead

Penunjuk ke ULONG tempat metode ini menulis jumlah byte aktual yang dibaca dari array byte. Anda dapat mengatur penunjuk ini ke NULL untuk menunjukkan bahwa Anda tidak tertarik dengan nilai ini. Dalam hal ini, metode ini tidak memberikan jumlah byte aktual yang dibaca.

Nilai kembali

Metode ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode	Deskripsi
S_OK	Menunjukkan bahwa jumlah byte yang ditentukan dibaca, atau jumlah maksimum byte dibaca ke akhir array byte.
E_FAIL	Data tidak dapat dibaca dari array byte.
E_PENDING	Hanya Penyimpanan Asinkron: Sebagian atau semua data yang akan dibaca saat ini tidak tersedia.
STG_E_ACCESSDENIED	Pemanggil tidak memiliki izin untuk mengakses array byte.
STG_E_READFAULT	Jumlah byte yang akan dibaca tidak sama dengan jumlah byte yang benar-benar dibaca.

Keterangan

ILockBytes::ReadAt membaca byte dari objek array byte. Ini melaporkan jumlah byte yang benar-benar dibaca. Nilai ini mungkin kurang dari jumlah byte yang diminta jika terjadi kesalahan atau jika akhir array byte tercapai selama pembacaan.

Ini bukan kesalahan untuk membaca kurang dari jumlah byte yang ditentukan jika operasi menemukan akhir array byte. Perhatikan bahwa ini adalah perilaku akhir file yang sama seperti yang ditemukan dalam file sistem file tabel alokasi file (FAT) MS-DOS.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [aplikasi desktop | Aplikasi UWP]
Server minimum yang didukung	Windows 2000 Server [aplikasi desktop | Aplikasi UWP]
Target Platform	Windows
Header	objidl.h
Pustaka	Uuid.lib
DLL	Ole32.dll

Lihat juga

ILockBytes - Implementasi File-Based

ILockBytes - Implementasi Memori Global

ILockBytes::WriteAt