Metode ILockBytes::SetSize (objidl.h)

Artikel
03/05/2024

Metode SetSize mengubah ukuran array byte.

Sintaks

HRESULT SetSize(
  [in] ULARGE_INTEGER cb
);

Parameter

[in] cb

Menentukan ukuran baru array byte sebagai sejumlah byte.

Nilai kembali

Metode ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode	Deskripsi
S_OK	Ukuran array byte berhasil diubah.
STG_E_ACCESSDENIED	Pemanggil tidak memiliki izin untuk mengakses array byte.
STG_E_MEDIUMFULL	Ukuran array byte tidak diubah karena tidak ada ruang yang tersisa pada perangkat penyimpanan.

Keterangan

ILockBytes::SetSize mengubah ukuran array byte. Jika parameter cb lebih besar dari array byte saat ini, array byte diperluas ke ukuran yang ditunjukkan dengan mengisi ruang intervensi dengan byte nilai yang tidak terdefinisi, seperti halnya ILockBytes::WriteAt, jika penunjuk pencarian melewati akhir aliran saat ini.

Jika parameter cb lebih kecil dari array byte saat ini, array byte dipotong ke ukuran yang ditunjukkan.

Catatan untuk Penelepon

Penelepon tidak dapat mengandalkan STG_E_MEDIUMFULL dikembalikan pada waktu yang tepat karena buffering cache dalam sistem operasi atau jaringan. Namun, penelepon harus dapat menangani kode pengembalian ini karena beberapa implementasi ILockBytes mungkin mendukungnya.

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