Metode IByteBuffer::SetSize
[Metode SetSize tersedia untuk digunakan dalam sistem operasi yang ditentukan di bagian Persyaratan. Ini tidak tersedia untuk digunakan di Windows Server 2003 dengan Paket Layanan 1 (SP1) dan yang lebih baru, Windows Vista, Windows Server 2008, dan versi sistem operasi berikutnya. Antarmuka IStream menyediakan fungsionalitas serupa.]
Metode SetSize mengubah ukuran objek stream.
Sintaks
HRESULT SetSize(
[in] LONG libNewSize
);
Parameter
-
libNewSize [in]
-
Ukuran aliran baru sebagai sejumlah byte
Menampilkan nilai
Nilai yang dikembalikan adalah HRESULT. Nilai S_OK menunjukkan bahwa panggilan berhasil.
Keterangan
Metode IByteBuffer::SetSize mengubah ukuran objek stream. Panggil metode ini untuk melakukan pra-alokasi ruang untuk aliran. Jika parameter libNewSize lebih besar dari ukuran aliran saat ini, aliran diperluas ke ukuran yang ditunjukkan dengan mengisi ruang intervensi dengan byte nilai yang tidak terdefinisi. Operasi ini mirip dengan metode IByteBuffer::Write jika penunjuk pencarian melewati akhir aliran saat ini.
Jika parameter libNewSize lebih kecil dari aliran saat ini, maka aliran dipotong ke ukuran yang ditunjukkan.
Penunjuk pencarian tidak terpengaruh oleh perubahan ukuran aliran.
Memanggil IByteBuffer::SetSize dapat menjadi cara yang efektif untuk mencoba mendapatkan sebagian besar ruang yang berdampingan.
Contoh
Contoh berikut menunjukkan pengaturan ukuran buffer.
LONG lNewSize = 256;
HRESULT hr;
// Change the buffer size.
hr = pIByteBuff->SetSize(lNewSize);
if (FAILED(hr))
printf("Failed IByteBuffer::SetSize\n");
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung |
Windows XP [hanya aplikasi desktop] |
Server minimum yang didukung |
Windows Server 2003 [hanya aplikasi desktop] |
Akhir dukungan klien |
Windows XP |
Akhir dukungan server |
Windows Server 2003 |
Header |
|
Pustaka jenis |
|
DLL |
|
IID |
IID_IByteBuffer didefinisikan sebagai E126F8FE-A7AF-11D0-B88A-00C04FD424B9 |
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk