Compartilhar via


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

Executa as operações necessárias antes de chamar IMalloc::Alloc.

Sintaxe

SIZE_T PreAlloc(
  [in] SIZE_T cbRequest
);

Parâmetros

[in] cbRequest

O número de bytes especificados na solicitação de alocação que o chamador está passando para Alloc.

Retornar valor

O número de bytes especificados na chamada para Alloc, que pode ser maior ou igual ao valor de cbRequest.

Comentários

A implementação preAlloc pode estender e/ou modificar a alocação para armazenar informações específicas de depuração com a alocação.

PreAlloc pode forçar a falha de alocação de memória retornando 0, permitindo que o teste garanta que o aplicativo trate a falha de alocação normalmente em todos os casos. Nesse caso, IMallocSpy::P ostAlloc não é chamado e Alloc retorna NULL. Forçar a falha de alocação só será eficaz se cbRequest não for igual a 0. Se PreAlloc estiver forçando a falha retornando NULL, PostAlloc não será chamado. No entanto, Alloc encontra uma falha de memória real e retorna NULL, PostAlloc é chamado.

A chamada para PreAlloc por meio do retorno de PostAlloc tem a garantia de ser thread-safe.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho objidl.h

Confira também

IMalloc::Alloc

Imallocspy

IMallocSpy::P ostAlloc