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 |
|---|---|
|
Die Methode wurde erfolgreich abgeschlossen. |
|
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 |