Fungsi WsAlloc (webservices.h)

Artikel
03/03/2024

Mengalokasikan segmen memori dari tumpukan yang ditentukan.

Sintaks

HRESULT WsAlloc(
  [in]           WS_HEAP  *heap,
  [in]           SIZE_T   size,
                 void     **ptr,
  [in, optional] WS_ERROR *error
);

Parameter

[in] heap

Arahkan ke struktur WS_HEAP yang mewakili timbunan untuk mengalokasikan memori.

[in] size

Jumlah byte yang akan dialokasikan. Nilai ini bisa nol.

ptr

Jika berhasil, pointer yang menerima alamat memori yang dialokasikan. Pointer ini berlaku sampai WsFreeHeap atau WsResetHeap dipanggil pada heap.

Penunjuk yang dikembalikan diratakan pada batas 8-byte.

Alokasi byte nol akan mengembalikan penunjuk non-NULL.

[in, optional] error

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

Mengembalikan nilai

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

Menampilkan kode	Deskripsi
WS_E_QUOTA_EXCEEDED	Byte yang diminta, selain byte yang sudah dialokasikan, melebihi ukuran timbunan, seperti yang ditentukan oleh properti WS_HEAP_PROPERTY_MAX_SIZE .
E_OUTOFMEMORY	Tidak cukup memori untuk menyelesaikan operasi.

Keterangan

Memori yang dikembalikan oleh fungsi ini bukan nol yang diinisialisasi dan berisi nilai yang tidak terdefinisi.

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