WsCreateHeap, fonction (webservices.h)

Article
08/27/2023

Crée un objet tas .

Syntaxe

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

Paramètres

[in] maxSize

Nombre total d’octets pouvant être alloués à partir du tas. Le nombre total d’octets est défini comme somme des tailles passées dans tous les appels à la fonction WsAlloc depuis la création ou la réinitialisation du tas.

[in] trimSize

Nombre maximal d’octets de mémoire que le tas conserve une fois que le tas a été réinitialisé par un appel à la fonction WsResetHeap . Il s’agit d’une valeur d’approximation due à la surcharge du tas.

Note Si la valeur de trimSize est supérieure à la valeur de maxSize, la taille du tas n’est pas ajustée à la taille souhaitée.

[in, optional] properties

Réservé à une utilisation ultérieure ; défini sur NULL.

[in] propertyCount

Réservé à une utilisation ultérieure ; défini sur 0 (zéro).

heap

En cas de réussite, pointeur qui reçoit l’adresse du WS_HEAP structure représentant le nouvel objet tas.

[in, optional] error

Pointeur vers une structure de WS_ERROR qui reçoit des informations d’erreur supplémentaires en cas d’échec de la fonction.

Valeur retournée

Si la fonction réussit, elle retourne NO_ERROR ; sinon, il retourne un code d’erreur HRESULT.

Remarques

Un tas dans l’API des services web Windows est une allocation de mémoire utilisée pour les messages. Les tas peuvent également être utilisés pour stocker les données de message séparément de la durée de vie d’un message. Certaines fonctions d’API permettent un contrôle explicite du tas sur la durée de vie des données lues.

La création d’un segment de mémoire n’alloue aucune mémoire (à l’exception de la mémoire nécessaire pour WS_HEAP structure elle-même). Les paramètres maxSize et trimSize sont utilisés comme quotas uniquement pour les opérations WsAlloc et WsResetHeap .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7 [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	webservices.h
Bibliothèque	WebServices.lib
DLL	WebServices.dll

Partager via