Share via

ICallFrame ::Invoke, méthode (callobj.h)

  • Article

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.

Syntaxe

HRESULT Invoke(
  [in] void *pvReceiver,
       ...  
);

Paramètres

[in] pvReceiver

Interface sur laquelle l’appel doit se produire. L’appelant est responsable de s’assurer que cette interface est de l’IID approprié ; l’implémentation effectue simplement un cast et suppose que c’est le cas.

...

Paramètres supplémentaires.

Valeur retournée

Cette méthode peut retourner les valeurs suivantes.

Code de retour Description
S_OK
 La commande s'est correctement terminée.
CALLFRAME_E_ALREADYINVOKED
 Un appel a déjà été effectué à partir de ce cadre.
E_UNEXPECTED
 Une erreur inattendue s’est produite.

Remarques

En règle générale, l’appel implique l’allocation d’une nouvelle trame de pile, la copie superficielle des données dans le cadre d’origine, puis l’appel de la méthode appropriée dans l’objet indiqué. L’objet appelé peut ensuite choisir de modifier les paramètres [out], accessibles à partir du cadre copié, en fonction de la sémantique appropriée de l’appel. Lorsque l’appel est retourné à partir de l’objet, le cadre d’appel capture automatiquement la valeur de retour à partir de 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