Metodo ICallFrameEvents::OnCall (callobj.h)

Informa il sink di eventi se riceve una chiamata al metodo sull'intercettatore. Il sink viene fornito con un'istanza ICallFrame associata alla chiamata al metodo in ingresso intercettato. Attraverso tale sink il frame di chiamata può essere manipolato in vari modi.

Sintassi

HRESULT OnCall(
  [in] ICallFrame *pFrame
);

Parametri

[in] pFrame

Frame di chiamata associato alla chiamata appena ricevuta.

Valore restituito

Questo metodo può restituire i valori seguenti.

Codice restituito Descrizione
S_OK
Metodo completato correttamente.
E_UNEXPECTED
Si è verificato un errore imprevisto.

Commenti

In caso di ritorno da OnCall, l'intercettatore presuppone che, in alcuni casi, i valori out-value del metodo siano stati inizializzati in modo appropriato, se necessario; l'intercettatore non modifica ulteriormente il frame di chiamata. In genere, l'implementazione di OnCall avrà impostato i valori out per alcuni mezzi, richiamando il frame di chiamata in un oggetto, annullando correttamente alcune operazioni di marshalling di alcuni valori out in precedenza o cancellandoli con ICallFrame::Free.

Il valore restituito deve essere stato impostato in modo appropriato anche durante la chiamata in modo analogo. Vedere ICallFrame::SetReturnValue.

Requisiti

Requisito Valore
Client minimo supportato Windows 2000 Professional [solo app desktop]
Server minimo supportato Windows 2000 Server [solo app desktop]
Piattaforma di destinazione Windows
Intestazione callobj.h

Vedi anche

ICallFrame

ICallFrameEvents