Metode ILockBytes::WriteAt (objidl.h)

Artikel
03/05/2024

Metode WriteAt menulis jumlah byte yang ditentukan mulai dari offset tertentu dari awal array byte.

Sintaks

HRESULT WriteAt(
  [in]  ULARGE_INTEGER ulOffset,
  [in]  const void     *pv,
  [in]  ULONG          cb,
  [out] ULONG          *pcbWritten
);

Parameter

[in] ulOffset

Menentukan titik awal dari awal array byte agar data ditulis.

[in] pv

Arahkan ke buffer yang berisi data yang akan ditulis.

[in] cb

Menentukan jumlah byte data untuk mencoba menulis ke dalam array byte.

[out] pcbWritten

Penunjuk ke lokasi di mana metode ini menentukan jumlah byte aktual yang ditulis ke 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 ditulis.

Nilai kembali

Metode ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode	Deskripsi
S_OK	Menunjukkan bahwa jumlah byte yang ditentukan ditulis.
E_FAIL	Kegagalan umum terjadi selama operasi tulis.
E_PENDING	Hanya Penyimpanan Asinkron: Bagian atau semua data yang akan ditulis saat ini tidak tersedia.
STG_E_ACCESSDENIED	Pemanggil tidak memiliki cukup izin untuk menulis array byte ini.
STG_E_WRITEFAULT	Jumlah byte yang akan ditulis tidak sama dengan jumlah byte yang benar-benar ditulis.
STG_E_MEDIUMFULL	Operasi tulis tidak selesai karena tidak ada ruang yang tersisa pada perangkat penyimpanan. Jumlah aktual byte yang ditulis masih dikembalikan dalam pcbWritten.

Keterangan

ILockBytes::WriteAt menulis data yang ditentukan di lokasi yang ditentukan dalam array byte. Jumlah byte yang benar-benar ditulis harus selalu dikembalikan dalam pcbWritten, bahkan jika kesalahan dikembalikan. Jika jumlah byte nol byte, operasi tulis tidak berpengaruh.

Jika ulOffset melewati akhir array byte dan cb lebih besar dari nol, ILockBytes::WriteAt meningkatkan ukuran array byte. Byte isian yang ditulis ke array byte tidak diinisialisasi ke nilai tertentu.

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::ReadAt

ILockBytes::SetSize

Bagikan melalui