Interface ICallFrame (callobj.h)

Permet la manipulation des trames d’appel telles que les trames de pile. Le cadre d’appel est le corps des informations qu’une procédure doit enregistrer pour lui permettre de revenir correctement à son appelant. Une trame d’appel peut exister sur la pile ou dans les registres. Une trame de pile conserve les informations de contexte de son appelant sur la pile.

Une instance de l’interface ICallFrame peut effectuer différentes transformations sur une trame d’appel. L’appel peut être marshalé ou conservé. Le instance de cette interface est lié et a un numéro de méthode associé.

Héritage

L’interface ICallFrame hérite de l’interface IUnknown. ICallFrame a également les types de membres suivants :

Méthodes

L’interface ICallFrame comporte ces méthodes.

ICallFrame ::Copy Crée une copie de ce cadre d’appel et de toutes les données associées.
ICallFrame ::Free Libère la copie du cadre pour éviter une fuite de mémoire.
ICallFrame ::FreeParam Libère le paramètre spécifié dans le cadre.
ICallFrame ::GetIIDAndMethod Récupère l’ID d’interface ou le numéro de méthode.
ICallFrame ::GetInfo Récupère des informations sur le cadre d’appel.
ICallFrame ::GetMarshalSizeMax Récupère une limite supérieure sur le nombre d’octets nécessaires pour marshaler l’image d’appel.
ICallFrame ::GetNames Récupère le nom de la méthode ou de l’interface de cet appel.
ICallFrame ::GetParam Récupère la valeur d’un paramètre spécifié dans le cadre d’appel.
ICallFrame ::GetParamInfo Récupère les informations du paramètre spécifié.
ICallFrame ::GetReturnValue Récupère la valeur de retour stockée dans le cadre d’appel.
ICallFrame ::GetStackLocation Récupère l’emplacement de pile auquel cette trame d’appel est liée.
ICallFrame ::Invoke Applique cet enregistrement d’activation à un objet. Dans une situation de marshaling, cela est généralement effectué côté serveur et est le moyen par lequel le travail de l’objet réel est accompli.
ICallFrame ::Marshal Marshale l’image d’appel en transformant ses données accessibles en mémoire tampon plate sans perturber le cadre.
ICallFrame ::ReleaseMarshalData Libère les ressources qui sont conservées par les pointeurs d’interface résidant dans un paquet de données marshalées. Cette méthode recherche tous les pointeurs d’interface dans le paquet et appelle la fonction CoReleaseMarshalData sur chacun d’eux.
ICallFrame ::SetParam Définit la valeur d’un paramètre spécifié dans le cadre d’appel.
ICallFrame ::SetReturnValue Définit la valeur de retour dans le cadre d’appel.
ICallFrame ::SetStackLocation Définit l’emplacement de pile auquel cette trame d’appel est liée.
ICallFrame ::Unmarshal Désactive un paquet de données contenant les paramètres [out] précédemment marshalés d’un appel dans cet enregistrement d’activation déjà existant.
ICallFrame ::WalkFrame Recherche des pointeurs d’interface accessibles à partir des paramètres [in], [in, out] ou [out] du frame.

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