Méthode ICallFrameEvents ::OnCall (callobj.h)

Informe le récepteur d’événements s’il reçoit un appel de méthode sur l’intercepteur. Le récepteur est fourni avec un instance ICallFrame lié à l’appel de la méthode entrante interceptée. Grâce à ce récepteur, l’image d’appel peut être manipulée de différentes manières.

Syntaxe

HRESULT OnCall(
  [in] ICallFrame *pFrame
);

Paramètres

[in] pFrame

Cadre d’appel lié à l’appel qui vient de recevoir.

Valeur retournée

Cette méthode peut retourner les valeurs suivantes.

Code de retour	Description
S_OK	La commande s'est correctement terminée.
E_UNEXPECTED	Une erreur inattendue s’est produite.

Remarques

Au retour d’OnCall, l’intercepteur suppose que, par certains moyens, les valeurs hors-valeur de la méthode ont été initialisées de manière appropriée en fonction des besoins, le cas échéant ; l’intercepteur ne manipule pas davantage l’image d’appel. En règle générale, l’implémentation d’OnCall a défini les valeurs de sortie par certains moyens, soit en appelant l’image d’appel sur un objet, en démarshallant avec succès certaines valeurs out-précédemment marshalées, soit en les effaçant avec ICallFrame ::Free.

La valeur de retour doit également avoir été correctement définie pendant l’appel de la même manière. Consultez ICallFrame ::SetReturnValue.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	callobj.h

Voir aussi

ICallFrame

ICallFrameEvents