Función WsCreateHeap (webservices.h)

Crea un objeto de montón .

Sintaxis

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

Parámetros

[in] maxSize

Número total de bytes que se pueden asignar desde el montón. El número total de bytes se define como suma de los tamaños pasados en todas las llamadas a la función WsAlloc desde que se creó o restableció el montón.

[in] trimSize

Número máximo de bytes de memoria que conserva el montón después de restablecer el montón mediante una llamada a la función WsResetHeap . Se trata de un valor de aproximación debido a la sobrecarga del montón.

Nota Si el valor de trimSize es mayor que el valor de maxSize, el tamaño del montón no se ajustará al tamaño deseado.

 

[in, optional] properties

Reservado para uso futuro; se establece en NULL.

[in] propertyCount

Reservado para uso futuro; se establece en 0 (cero).

heap

Si se ejecuta correctamente, puntero que recibe la dirección de la estructura WS_HEAP que representa el nuevo objeto de montón.

[in, optional] error

Puntero a una estructura de WS_ERROR que recibe información de error adicional si se produce un error en la función.

Valor devuelto

Si la función se realiza correctamente, devuelve NO_ERROR; de lo contrario, devuelve un código de error HRESULT.

Comentarios

Un montón en la API de servicios web de Windows es una asignación de memoria que se usa para los mensajes. Los montones también se pueden usar para almacenar datos de mensajes por separado de la duración de un mensaje. Algunas funciones de API permiten un control explícito del montón durante la duración de cualquier lectura de datos.

La creación de un montón no asigna ninguna memoria (excepto la memoria necesaria para WS_HEAP propia estructura). Los parámetros maxSize y trimSize se usan como cuotas solo con las operaciones WsAlloc y WsResetHeap .

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7 [aplicaciones de escritorio | Aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2008 R2 [aplicaciones de escritorio | Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	webservices.h
Library	WebServices.lib
Archivo DLL	WebServices.dll