ICallFrameEvents::OnCall-Methode (callobj.h)

Informiert die Ereignissenke, wenn sie einen Methodenaufruf für den Interceptor empfängt. Die Senke wird mit einem ICallFrame-instance bereitgestellt, der an den abgefangenen eingehenden Methodenaufruf gebunden ist. Durch diese Senke kann der Aufrufrahmen auf verschiedene Weise bearbeitet werden.

Syntax

HRESULT OnCall(
  [in] ICallFrame *pFrame
);

Parameter

[in] pFrame

Ein Aufrufrahmen, der an den gerade empfangenen Aufruf gebunden ist.

Rückgabewert

Diese Methode kann die folgenden Werte zurückgeben.

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich abgeschlossen.
E_UNEXPECTED	Ein unerwarteter Fehler ist aufgetreten.

Hinweise

Bei der Rückgabe von OnCall geht der Interceptor davon aus, dass die Out-Werte der Methode ggf. entsprechend initialisiert wurden. der Interceptor selbst bearbeitet den Aufrufrahmen in keiner Weise weiter. In der Regel hat die OnCall-Implementierung die Out-Werte auf irgendeine Weise festgelegt, entweder durch Aufrufen des Aufrufrahmens für ein Objekt, erfolgreiches Aufheben einiger zuvor gemarster Out-Werte oder löschen sie mit ICallFrame::Free.

Der Rückgabewert sollte auch während des Aufrufs auf ähnliche Weise festgelegt werden. Siehe ICallFrame::SetReturnValue.

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	callobj.h

Weitere Informationen

ICallFrame

ICallFrameEvents