WsCreateHeap-Funktion (webservices.h)

Artikel
03/06/2024

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.

Hinweis Wenn der Wert von trimSize größer als der Wert von maxSize ist, wird die Größe des Heaps nicht an die gewünschte Größe angepasst.

[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

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	webservices.h
Bibliothek	WebServices.lib
DLL	WebServices.dll

Freigeben über