WsCreateHeap 函式 (webservices.h)

建立 堆積 物件。

語法

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

參數

[in] maxSize

可從堆積配置的位元組總數。 自建立或重設堆積之後，所有呼叫 WsAlloc 函式中傳遞的大小總和會定義為位元組總數。

[in] trimSize

堆積在呼叫 WsResetHeap 函式之後，堆積所保留的最大記憶體位元組數。 這是堆積額外負荷所造成的近似值。

[in, optional] properties

保留供日後使用;設定為 NULL。

[in] propertyCount

保留供日後使用;設定為 0 (零) 。

heap

成功時，會接收代表新堆積物件 之WS_HEAP 結構的位址的指標。

[in, optional] error

如果函式失敗，WS_ERROR結構的指標，該結構會收到其他錯誤資訊。

傳回值

如果函式成功，它會傳回NO_ERROR;否則會傳回 HRESULT 錯誤碼。

備註

Windows Web 服務 API 中的堆積是用於 訊息的記憶體配置。 堆積也可用來將訊息數據與訊息的存留期分開儲存。 某些 API 函式允許明確堆積控制任何讀取數據的存留期。

除了 WS_HEAP 結構) 本身所需的記憶體以外，建立新的堆積不會配置任何記憶體 (。 maxSize 和 trimSize 參數僅作為配額使用 WsAlloc 和 WsResetHeap 作業。

規格需求