共用方式為


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

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

傳回的指標會對齊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