Funzione WsCreateHeap (webservices.h)

Articolo
03/03/2024

Crea un oggetto heap .

Sintassi

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
);

Parametri

[in] maxSize

Numero totale di byte che possono essere allocati dall'heap. Il numero totale di byte viene definito come somma delle dimensioni passate in tutte le chiamate alla funzione WsAlloc dal momento che l'heap è stato creato o reimpostato.

[in] trimSize

Numero massimo di byte di memoria mantenuti dall'heap dopo la reimpostazione dell'heap da una chiamata alla funzione WsResetHeap . Si tratta di un valore di approssimazione dovuto al sovraccarico dell'heap.

Nota Se il valore di trimSize è maggiore del valore di maxSize, le dimensioni dell'heap non verranno modificate alle dimensioni desiderate.

[in, optional] properties

Riservato per l'uso futuro; impostato su NULL.

[in] propertyCount

Riservato per l'uso futuro; impostato su 0 (zero).

heap

In caso di esito positivo, puntatore che riceve l'indirizzo della struttura WS_HEAP che rappresenta il nuovo oggetto heap.

[in, optional] error

Puntatore a una struttura WS_ERROR che riceve informazioni di errore aggiuntive 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.

Commenti

Un heap nell'API di Servizi Web Windows è un'allocazione di memoria usata per i messaggi. È anche possibile usare Heaps per archiviare i dati dei messaggi separatamente dalla durata di un messaggio. Alcune funzioni API consentono il controllo heap esplicito durante la durata di qualsiasi lettura dei dati.

La creazione di un nuovo heap non alloca alcuna memoria (ad eccezione della memoria necessaria per WS_HEAP struttura stessa). I parametri maxSize e trimSize vengono usati come quote solo durante le operazioni WsAlloc e WsResetHeap .

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