WsCreateHeap-Funktion (webservices.h)

Erstellt ein Heapobjekt .

Syntax

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

Die Gesamtanzahl der Bytes, die aus dem Heap zugeordnet werden können. Die Gesamtanzahl der Bytes wird als Summe der Größen definiert, die in allen Aufrufen der WsAlloc-Funktion übergeben wurden, seit der Heap erstellt oder zurückgesetzt wurde.

[in] trimSize

Die maximale Anzahl von Bytes an Arbeitsspeicher, die der Heap nach dem Zurücksetzen des Heaps durch einen Aufruf der WsResetHeap-Funktion beibehält. Dies ist ein Näherungswert aufgrund des Heapaufwands.

[in, optional] properties

Für zukünftige Verwendung reserviert; auf NULL festgelegt.

[in] propertyCount

Für zukünftige Verwendung reserviert; auf 0 (null) festgelegt.

heap

Bei Erfolg: Zeiger, der die Adresse der WS_HEAP Struktur empfängt, die das neue Heapobjekt darstellt.

[in, optional] error

Zeiger auf eine WS_ERROR-Struktur , die zusätzliche Fehlerinformationen empfängt, wenn die Funktion fehlschlägt.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird NO_ERROR zurückgegeben. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.

Hinweise

Ein Heap in der Windows-Webdienst-API ist eine Speicherbelegung, die für Nachrichten verwendet wird. Heaps können auch verwendet werden, um Nachrichtendaten getrennt von der Lebensdauer einer Nachricht zu speichern. Einige API-Funktionen ermöglichen eine explizite Heapsteuerung über die Lebensdauer aller gelesenen Daten.

Beim Erstellen eines neuen Heaps wird kein Arbeitsspeicher zugeordnet (mit Ausnahme des Arbeitsspeichers, der für WS_HEAP Struktur selbst erforderlich ist). Die Parameter maxSize und trimSize werden nur bei WsAlloc - und WsResetHeap-Vorgängen als Kontingente verwendet.

Anforderungen