共用方式為

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 函式之後，堆積所保留的最大記憶體位元組數。 這是堆積額外負荷所造成的近似值。

注意 如果 trimSize 的值大於 maxSize 的值，堆積的大小將不會調整為所需的大小。

 

[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 作業。

規格需求

需求 值
最低支援的用戶端 Windows 7 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2008 R2 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 webservices.h
程式庫 WebServices.lib
Dll WebServices.dll