Funzione WsAlloc (webservices.h)

Articolo
03/03/2024

Alloca un segmento di memoria dall'heap specificato.

Sintassi

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

Parametri

[in] heap

Puntatore a una struttura WS_HEAP che rappresenta l'heap da cui allocare la memoria.

[in] size

Numero di byte da allocare. Il valore può essere zero.

ptr

In caso di esito positivo, un puntatore che riceve l'indirizzo della memoria allocata. Questo puntatore è valido finché non viene chiamato WsFreeHeap o WsResetHeap nell'heap.

Il puntatore restituito è allineato su un limite di 8 byte.

Le allocazioni di byte zero restituiranno un puntatore non NULL.

[in, optional] error

Puntatore a una struttura WS_ERROR che riceve informazioni aggiuntive sull'errore se la funzione ha esito negativo.

Valore restituito

Se la funzione ha esito positivo, restituisce NO_ERROR; in caso contrario, restituisce un codice di errore HRESULT.

Codice restituito	Descrizione
WS_E_QUOTA_EXCEEDED	I byte richiesti, oltre ai byte già allocati, superano le dimensioni dell'heap, come specificato dalla proprietà WS_HEAP_PROPERTY_MAX_SIZE .
E_OUTOFMEMORY	Memoria insufficiente per completare l'operazione.

Commenti

La memoria restituita da questa funzione non è inizializzata zero e contiene valori non definiti.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [app desktop \| App UWP]
Server minimo supportato	Windows Server 2008 R2 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	webservices.h
Libreria	WebServices.lib
DLL	WebServices.dll

Condividi tramite