IMallocSpy::PreAlloc

9/8/2008

Este método é chamado apenas prior to chamando o IMalloc::Alloc método.

Syntax

ULONG PreAlloc(
  ULONG cbRequest 
);

Parameters

• cbRequest
  [no] Número de bytes especificado na solicitação de alocação que o chamador está passando para IMalloc::Alloc.

Return Value

O contagem de bytes, na verdade, passados para IMalloc::Alloc, que deve ser maior ou igual ao valor de cbRequest.

Remarks

O PreAlloc implementação pode estender ou modificar a alocação para armazenar informações Debug-specific com a alocação.

PreAlloc pode forçar memória alocação falha retornando zero, permitindo que testes para garantir que o aplicativo trata falha alocação normalmente em todos os casos. Neste maiúsculas e minúsculas, IMallocSpy::PostAlloc Não é chamado e IMalloc::Alloc retorna NULL.

Forçar falha alocação vigora apenas se cbRequest não é igual a zero.

Se PreAlloc está forçando falha retornando NULL, PostAlloc Não é chamado. No entanto, se IMalloc::Alloc encontrar uma falha memória real e retorna NULL, PostAlloc é chamado.

A chamar para PreAlloc Por meio de retorno do PostAlloc são garantidas serem thread-safe.

Para determinar se a plataforma oferece suporte a esta interface, consulte Determinando suporte COM APIs.

Requirements

Header	objidl.h, objidl.idl
Library	ole32.lib
Windows Embedded CE	Windows CE 3.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

IMalloc::Alloc
IMallocSpy::PostAlloc
CoRegisterMallocSpy
CoRevokeMallocSpy