Méthode IExpDispSupport ::OnInvoke (shdeprecated.h)

Article
03/09/2024

Action déconseillée. Obtient les propriétés ambiantes.

Syntaxe

HRESULT OnInvoke(
  [in] DISPID     dispidMember,
  [in] REFIID     iid,
  [in] LCID       lcid,
  [in] WORD       wFlags,
       DISPPARAMS *pdispparams,
       VARIANT    *pVarResult,
       EXCEPINFO  *pexcepinfo,
       UINT       *puArgErr
);

Paramètres

[in] dispidMember

Type : DISPID

ID de répartition qui identifie le membre appelé.

[in] iid

Type : REFIID

Réservé. Doit être IID_NULL.

[in] lcid

Type : LCID

ID de paramètres régionaux fournissant un contexte de paramètres régionaux dans lequel interpréter les arguments. Les applications qui ne prennent pas en charge plusieurs langues peuvent ignorer ce paramètre.

[in] wFlags

Type : WORD

Indicateurs décrivant le contexte de l’appel, y compris les éléments suivants.

DISPATCH_METHOD

Le membre est appelé en tant que méthode. Si une propriété porte le même nom, cet indicateur et l’indicateur DISPATCH_PROPERTYGET peuvent être définis. Le membre est appelé en tant que méthode. Si une propriété porte le même nom, cet indicateur et l’indicateur DISPATCH_PROPERTYGET peuvent être définis.

DISPATCH_PROPERTYGET

Le membre est récupéré en tant que membre de propriété ou de données.

DISPATCH_PROPERTYPUT

Le membre est modifié en tant que membre de propriété ou de données.

DISPATCH_PROPERTYPUTREF

Le membre est modifié par une attribution de référence plutôt que par une attribution de valeur. Cet indicateur est valide uniquement lorsque la propriété accepte une référence à un objet.

pdispparams

Type : DISPPARAMS*

Pointeur vers une structure DISPPARAMS contenant un tableau d’arguments, un tableau d’arguments DISPID pour les arguments nommés et le nombre d’éléments dans les tableaux.

pVarResult

Type : VARIANT*

Pointeur vers l’emplacement où le résultat doit être stocké ou NULL si l’appelant n’attend aucun résultat. Cet argument est ignoré si DISPATCH_PROPERTYPUT ou DISPATCH_PROPERTYPUTREF est spécifié.

pexcepinfo

Type : EXCEPINFO*

Pointeur vers une structure qui contient les informations sur les exceptions. Cette structure doit être renseignée si DISP_E_EXCEPTION est retourné. Peut être NULL.

puArgErr

Type : UINT*

Index dans le membre rgvarg de la structure DISPPARAMS du premier argument qui présente une erreur. Les arguments étant stockés dans rgvarg dans l’ordre inverse, le premier argument est celui avec l’index le plus élevé dans le tableau. Ce paramètre est retourné uniquement lorsque la valeur de retour obtenue est DISP_E_TYPEMISMATCH ou DISP_E_PARAMNOTFOUND. Cet argument peut être défini sur NULL.

Valeur retournée

Type : HRESULT

Si cette méthode réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Pour plus d’informations, consultez IDispatch ::Invoke.

Configuration requise

Condition requise	Valeur
Plateforme cible	Windows
En-tête	shdeprecated.h

Partager via