Share via

WsAlloc 函式 (webservices.h)

  • 發行項

從指定的 堆積配置記憶體區段。

語法

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

參數

[in] heap

WS_HEAP 結構的指標，代表要從中配置記憶體的堆積。

[in] size

要配置的位元組數目。 此值可以是零。

ptr

成功時，接收已配置記憶體位址的指標。 此指標有效，直到在堆積上呼叫 WsFreeHeap 或 WsResetHeap 為止。

傳回的指標會對齊8位元組界限。

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

[in, optional] error

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

傳回值

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

傳回碼 Description
WS_E_QUOTA_EXCEEDED
 除了已配置的位元組之外，要求的位元組還超過 堆積的大小，如 WS_HEAP_PROPERTY_MAX_SIZE 屬性所指定。
E_OUTOFMEMORY
 記憶體不足，無法完成作業。

備註

此函式傳回的記憶體不會初始化為零，而且包含未定義的值。

規格需求

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