CoRegisterMallocSpy-Funktion (objbase.h)
Registriert eine Implementierung der IMallocSpy-Schnittstelle . Danach muss OLE seine Wrappermethoden bei jedem Aufruf der entsprechenden IMalloc-Methode aufrufen.
Syntax
HRESULT CoRegisterMallocSpy(
[in] LPMALLOCSPY pMallocSpy
);
Parameter
[in] pMallocSpy
Ein Zeiger auf eine instance der IMallocSpy-Implementierung.
Rückgabewert
Diese Funktion kann den Standardrückgabewert E_INVALIDARG sowie die folgenden Werte zurückgeben.
Rückgabecode | BESCHREIBUNG |
---|---|
|
Das Objekt wurde erfolgreich registriert. |
|
Das Objekt ist bereits registriert. |
Hinweise
Die CoRegisterMallocSpy-Funktion registriert das IMallocSpy-Objekt , das zum Debuggen von Aufrufen von IMalloc-Methoden verwendet wird. Die Funktion ruft QueryInterface auf dem Zeiger pMallocSpy für die Schnittstelle IID_IMallocSpy auf. Dies ist, um sicherzustellen, dass pMallocSpy wirklich auf eine Implementierung von IMallocSpy verweist. Nach den OLE-Regeln wird erwartet, dass ein erfolgreicher Aufruf von QueryInterface einen Verweis (über die AddRef-Methode ) zum IMallocSpy-Objekt hinzugefügt hat. Das heißt, CoRegisterMallocSpy ruft AddRef nicht direkt auf pMallocSpy auf, erwartet aber vollständig, dass der QueryInterface-Aufruf ausgeführt wird.
Wenn das IMallocSpy-Objekt registriert wird, ruft OLE zuerst die entsprechende IMallocSpy-Prämethode auf, wenn eine der IMalloc-Methoden aufgerufen wird. Nach dem Ausführen der IMalloc-Methode ruft OLE dann die entsprechende IMallocSpy-Post-Methode auf. Wenn beispielsweise ein Aufruf von IMalloc::Alloc aus beliebiger Quelle erfolgt, ruft OLE IMallocSpy::P reAlloc auf, ruft Alloc auf und ruft nach Abschluss dieser Zuordnung IMallocSpy::P ostAlloc auf.
Anforderungen
Anforderung | Wert |
---|---|
Unterstützte Mindestversion (Client) | Windows 2000 Professional [nur Desktop-Apps] |
Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
Zielplattform | Windows |
Kopfzeile | objbase.h |
Bibliothek | Ole32.lib |
DLL | Ole32.dll |