|
CoRegisterMallocSpy
Registers an implementation of the IMallocSpy interface in OLE, thereafter requiring OLE to call its wrapper methods around
every call to the corresponding IMalloc method. IMallocSpy is defined in OLE to allow debugging of memory allocations.
HRESULT CoRegisterMallocSpy(
LPMALLOCSPY pMallocSpy
| //Pointer to an instance of IMallocSpy
| );
|
|
Parameter
pMallocSpy
Points to an instance of the IMallocSpy implementation.
Return Values
S_OK
Indicates the IMallocSpy object is successfully registered.
CO_E_OBJISREG
Indicates there is already a registered spy.
E_INVALIDARG
Indicates the call to the QueryInterface function in pMallocSpy for IID_IMallocSpy is unsuccessful, or pMallocSpy is NULL.
Comments
The CoRegisterMallocSpy function registers the IMallocSpy object, which is used to debug calls to IMalloc methods. The function calls QueryInterface on the pointer pMallocSpy for the interface IID_IMallocSpy. This is to ensure that pMallocSpy really supports an implementation of IMallocSpy. By the rules of OLE, it is expected that a successful call to QueryInterface has added a reference (through the AddRef function) to the IMallocSpy object. That is, CoRegisterMallocSpy does not directly call AddRef on pMallocSpy, but fully expects that the QueryInterface call will.
When the IMallocSpy object is registered, whenever there is a call to one of the IMalloc methods, OLE first calls the corresponding IMallocSpy pre-method. Then, after executing the IMalloc method, OLE calls the corresponding IMallocSpy post-method. For example, whenever there is a call to IMalloc::Alloc, from whatever source, OLE calls IMallocSpy::PreAlloc, calls IMalloc::Alloc, and after that allocation is completed, calls IMallocSpy::PostAlloc.
See Also
IMallocSpy, CoRevokeMallocSpy, CoGetMalloc
Related LinksSoftware for Delphi and C++ Builder developers
Software for Visual Studio .NET developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET
TMS Scripter Studio Pro components for Delphi/C++Builder
More Online Helps Win32 Programmer's Reference (win32.hlp)
Win32 Multimedia Programmer's Reference (mmedia.hlp)
Microsoft Windows Pen API Programmer's Reference (penapi.hlp)
Microsoft Windows Sockets 2 Reference (sock2.hlp)
Microsoft Windows Telephony API (TAPI) Programmer's Reference (sock2.hlp)
Unix Manual Pages
|
