Méthode IContextCallback::ContextCallback (ctxtcall.h)

Article
08/22/2023

Entre le contexte de l’objet, exécute la fonction spécifiée et retourne.

Syntaxe

HRESULT ContextCallback(
  [in] PFNCONTEXTCALL pfnCallback,
  [in] ComCallData    *pParam,
  [in] REFIID         riid,
  [in] int            iMethod,
  [in] IUnknown       *pUnk
);

Paramètres

[in] pfnCallback

Fonction à appeler à l’intérieur du contexte de l’objet.

[in] pParam

Données à passer à la fonction lorsqu’elle est appelée dans le contexte.

[in] riid

IID de l’appel en cours de simulation. Pour plus d'informations, consultez la section Notes.

[in] iMethod

Numéro de méthode de l’appel en cours de simulation. Pour plus d'informations, consultez la section Notes.

[in] pUnk

Ce paramètre est réservé et doit être NULL.

Valeur retournée

Cette méthode peut retourner les valeurs de retour standard E_INVALIDARG, E_OUTOFMEMORY, E_UNEXPECTED et E_FAIL. Si aucun de ces échecs ne se produit, la valeur de retour de cette fonction est la valeur HRESULT retournée par la fonction pfnCallback .

Remarques

Cette méthode simule un appel de méthode sur un objet à l’intérieur du contexte. Il est destiné aux opérations de bas niveau, telles que le nettoyage/marshaling différé, qui respectent les attentes de réentrance de l’application.

Pour fournir des informations sur l’infrastructure, vous devez spécifier un numéro d’interface et de méthode. Le paramètre riid ne doit pas être IID_IUnknown et le numéro de méthode ne doit pas être inférieur à 3.

Si riid a la valeur IID_IEnterActivityWithNoLock, la fonction est exécutée sans verrou d’activité.

Si riid est défini sur IID_ICallbackWithNoReentrancyToApplicationSTA, la fonction n’entre pas arbitrairement dans un ASTA. La plupart des applications doivent définir riid sur ces valeurs pour une utilisation à usage général.

Configuration requise


Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	ctxtcall.h

Voir aussi

IContextCallback

Partager via