Méthode IMallocSpy ::P reAlloc (objidl.h)

Effectue les opérations requises avant d’appeler IMalloc ::Alloc.

Syntaxe

SIZE_T PreAlloc(
  [in] SIZE_T cbRequest
);

Paramètres

[in] cbRequest

Nombre d’octets spécifié dans la demande d’allocation que l’appelant transmet à Alloc.

Valeur retournée

Nombre d’octets spécifié dans l’appel à Alloc, qui peut être supérieur ou égal à la valeur de cbRequest.

Remarques

L’implémentation de PreAlloc peut étendre et/ou modifier l’allocation pour stocker des informations spécifiques au débogage avec l’allocation.

PreAlloc peut forcer l’échec de l’allocation de mémoire en retournant 0, ce qui permet aux tests de s’assurer que l’application gère correctement l’échec d’allocation dans tous les cas. Dans ce cas, IMallocSpy ::P ostAlloc n’est pas appelé et Alloc retourne NULL. Le forçage de l’échec d’allocation n’est effectif que si cbRequest n’est pas égal à 0. Si PreAlloc force l’échec en retournant NULL, PostAlloc n’est pas appelé. Toutefois, Alloc rencontre un véritable échec de mémoire et retourne NULL, PostAlloc est appelé.

L’appel à PreAlloc via le retour de PostAlloc est garanti pour être thread-safe.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	objidl.h

Voir aussi

IMalloc ::Alloc

IMallocSpy

IMallocSpy ::P ostAlloc