WsAlloc-Funktion (webservices.h)

Ordnet ein Segment des Arbeitsspeichers aus dem angegebenen Heap zu.

Syntax

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

Parameter

[in] heap

Zeiger auf eine WS_HEAP Struktur, die den Heap darstellt, aus dem der Speicher zugeordnet werden soll.

[in] size

Die Anzahl der zu belegenden Bytes. Dieser Wert kann auch 0 sein.

ptr

Bei Erfolg ein Zeiger, der die Adresse des zugeordneten Arbeitsspeichers empfängt. Dieser Zeiger ist gültig, bis WsFreeHeap oder WsResetHeap auf dem Heap aufgerufen wird.

Der zurückgegebene Zeiger wird an einer 8-Byte-Grenze ausgerichtet.

Null-Bytezuordnungen geben einen Zeiger ohne NULL zurück.

[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

Der von dieser Funktion zurückgegebene Arbeitsspeicher ist nicht null initialisiert und enthält nicht definierte Werte.

Anforderungen