堆積

堆積會追蹤一組配置，這些配置會以單位的形式釋放。

這可讓您在使用 WWSAPI 時避免配置和解除配置記憶體的複雜模式。

每個訊息都有相關聯的堆積。 當訊息正在傳送或收到訊息時，訊息的堆積會用於與該特定訊息相關的任何配置。 傳送或接收訊息之後，堆積會重設 (，以清除與特定訊息相關的任何配置) 。

堆積也可以用來將訊息資料與訊息的存留期分開儲存。 許多 API 允許在讀取資料時使用的堆積規格，可明確控制讀取之任何資料的存留期。

保證堆積的配置在至少 8 個位元組界限上對齊。

零位元組配置會傳回非 Null 指標。

在 Windows 7 中，如果已啟用 PageHeap，則會使用從 HeapCreate 傳回的堆積來管理記憶體。 在此情況下， WsAlloc 會直接對應至 HeapAlloc， 而 WsResetHeap 會對應至 HeapDestroy。

下列列舉會與堆積搭配使用：

• WS_HEAP_PROPERTY_ID

下列函式會與堆積搭配使用：

• WsAlloc
• WsCreateHeap
• WsFreeHeap
• WsGetHeapProperty
• WsResetHeap

下列控制碼會與堆積搭配使用：

• WS_HEAP

下列結構會與堆積搭配使用：

• WS_HEAP_PROPERTIES
• WS_HEAP_PROPERTY