Поделиться через


Метод ICallFrameEvents::OnCall (callobj.h)

Сообщает приемнику событий, если он получает вызов метода для перехватчика. Приемник предоставляется с экземпляром ICallFrame , привязанным к вызову перехвата входящего метода. С помощью этого приемника кадром вызова можно управлять различными способами.

Синтаксис

HRESULT OnCall(
  [in] ICallFrame *pFrame
);

Параметры

[in] pFrame

Кадр вызова, привязанный к только что полученному вызову.

Возвращаемое значение

Этот метод может возвращать следующие значения.

Код возврата Описание
S_OK
Метод завершился успешно.
E_UNEXPECTED
Произошла непредвиденная ошибка.

Комментарии

При возвращении из OnCall перехватчик предполагает, что в некоторых случаях исходящие значения метода были соответствующим образом инициализированы по мере необходимости, если таковые имеются; перехватчик сам по себе не управляет кадром вызова. Как правило, реализация OnCall задает значения out-values с помощью вызова кадра для объекта, успешно отменив некоторые ранее маршалированные значения или очисив их с помощью ICallFrame::Free.

Возвращаемое значение также должно быть соответствующим образом задано во время вызова аналогичным образом. См. раздел ICallFrame::SetReturnValue.

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header callobj.h

См. также раздел

ICallFrame

ICallFrameEvents