Metode ILockBytes::WriteAt (objidl.h)
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