Fungsi WsCreateHeap (webservices.h)

Artikel
08/27/2023

Membuat objek heap .

Sintaks

HRESULT WsCreateHeap(
  [in]           SIZE_T                 maxSize,
  [in]           SIZE_T                 trimSize,
  [in, optional] const WS_HEAP_PROPERTY *properties,
  [in]           ULONG                  propertyCount,
                 WS_HEAP                **heap,
  [in, optional] WS_ERROR               *error
);

Parameter

[in] maxSize

Jumlah total byte yang dapat dialokasikan dari timbunan. Jumlah total byte didefinisikan sebagai jumlah ukuran yang diteruskan dalam semua panggilan ke fungsi WsAlloc sejak tumpukan dibuat atau direset.

[in] trimSize

Jumlah maksimum byte memori yang dipertahankan tumpukan setelah tumpukan direset oleh panggilan ke fungsi WsResetHeap . Ini adalah nilai perkiraan karena overhead heap.

Catatan Jika nilai trimSize lebih besar dari nilai maxSize, ukuran tumpukan tidak akan disesuaikan dengan ukuran yang diinginkan.

[in, optional] properties

Dicadangkan untuk digunakan di masa mendatang; atur ke NULL.

[in] propertyCount

Dicadangkan untuk digunakan di masa mendatang; atur ke 0 (nol).

heap

Jika berhasil, pointer yang menerima alamat struktur WS_HEAP mewakili objek heap baru.

[in, optional] error

Penunjuk ke struktur WS_ERROR yang menerima informasi kesalahan tambahan jika fungsi gagal.

Nilai kembali

Jika fungsi berhasil, fungsi akan mengembalikan NO_ERROR; jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Timbunan di Windows Web Services API adalah alokasi memori yang digunakan untuk pesan. Timbunan juga dapat digunakan untuk menyimpan data pesan secara terpisah dari masa pakai pesan. Beberapa fungsi API memungkinkan kontrol timbunan eksplisit selama masa pakai pembacaan data apa pun.

Membuat timbunan baru tidak mengalokasikan memori apa pun (kecuali memori yang diperlukan untuk struktur WS_HEAP itu sendiri). Parameter maxSize dan trimSize digunakan sebagai kuota yang hanya mengoperasikan WsAlloc dan WsResetHeap .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7 [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2008 R2 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	webservices.h
Pustaka	WebServices.lib
DLL	WebServices.dll

Bagikan melalui