CoRegisterMallocSpy

9/8/2008

Essa função registra uma implementação das IMallocSpy interface no OLE, daí em diante exigindo OLE para chamar seus métodos wrapper em torno cada chamar para o correspondente IMalloc método. IMallocSpy é definido em OLE para permitir que os desenvolvedores a depuração memória alocações.

Syntax

HRESULT CoRegisterMallocSpy(
  LPMALLOCSPY pMallocSpy
);

Parameters

• pMallocSpy
  [no] Ponteiro para uma instância das IMallocSpy implementação.

Return Value

Essa função suporta o padrão valor de retorno E_INVALIDARG, bem como o seguinte:

• S_OK
  O IMallocSpy objeto é registrado com êxito.

• CO_E_OBJISREG
  Já há um espião registrado.

Remarks

O CoRegisterMallocSpy função registra o IMallocSpy objeto, que é usado para depuração chamadas para IMalloc Métodos.

Chamadas de função Falha de QueryInterface Sobre o ponteiro pMallocSpy Para a interface IID_IMallocSpy. Isso é garantir que pMallocSpy Na verdade aponta para uma implementação de IMallocSpy.

Pelas regras de OLE, ele é esperado que um bem-sucedido chamar para Falha de QueryInterface Adicionou uma referência (através de AddRef método) para o IMallocSpy WScript.Shell. Ou seja, CoRegisterMallocSpy chamar não diretamente AddRef Em pMallocSpy, mas totalmente espera que o Falha de QueryInterface chamar será.

Quando o IMallocSpy objeto é registrado, sempre que houver uma chamar para um do IMalloc métodos, OLE primeiro chama o correspondente IMallocSpy Pre-Method. Em seguida, após executar o IMalloc método, OLE chama o correspondente IMallocSpy Post-Method.

Para exemplo, sempre há uma chamar para IMalloc::Alloc, de qualquer origem, chamadas OLE PreAlloc, chamadas IMalloc::Alloce após a conclusão dessa alocação, chamadas IMallocSpy::PostAlloc.

Para determinar se a plataforma oferece suporte a essa função, consulte Determinando suporte COM APIs.

Requirements

Header	objbase.h
Library	ole32.lib
Windows Embedded CE	Windows CE 3.0 and later
Windows Mobile	Windows Mobile Version 5.0 and later

See Also

Reference

COM Functions