ITypeInfo.Invoke Method

Definition

Invokes a method, or accesses a property of an object, that implements the interface described by the type description.

public:
 void Invoke(System::Object ^ pvInstance, int memid, short wFlags, System::Runtime::InteropServices::ComTypes::DISPPARAMS % pDispParams, IntPtr pVarResult, IntPtr pExcepInfo, [Runtime::InteropServices::Out] int % puArgErr);
public void Invoke (object pvInstance, int memid, short wFlags, ref System.Runtime.InteropServices.ComTypes.DISPPARAMS pDispParams, IntPtr pVarResult, IntPtr pExcepInfo, out int puArgErr);
abstract member Invoke : obj * int * int16 * DISPPARAMS * nativeint * nativeint * int -> unit
Public Sub Invoke (pvInstance As Object, memid As Integer, wFlags As Short, ByRef pDispParams As DISPPARAMS, pVarResult As IntPtr, pExcepInfo As IntPtr, ByRef puArgErr As Integer)

Parameters

pvInstance
Object

A reference to the interface described by this type description.

memid
Int32

A value that identifies the interface member.

wFlags
Int16

Flags that describe the context of the invoke call.

pDispParams
DISPPARAMS

A reference to a structure that contains an array of arguments, an array of DISPIDs for named arguments, and counts of the number of elements in each array.

pVarResult
IntPtr

nativeint

A reference to the location at which the result is to be stored. If wFlags specifies DISPATCH_PROPERTYPUT or DISPATCH_PROPERTYPUTREF, pVarResult is ignored. Set to null if no result is desired.

pExcepInfo
IntPtr

nativeint

A pointer to an exception information structure, which is filled in only if DISP_E_EXCEPTION is returned.

puArgErr
Int32

If Invoke returns DISP_E_TYPEMISMATCH, puArgErr indicates the index within rgvarg of the argument with the incorrect type. If more than one argument returns an error, puArgErr indicates only the first argument with an error. This parameter is passed uninitialized.

Remarks

The values of the pDispParams parameter can be accessed through the PtrToStructure method.

Valid values for the wFlags parameter are:

Value Description
DISPATCH_METHOD The member is accessed as a method. If there is ambiguity, both this flag and the DISPATCH_PROPERTYGET flag can be set.
DISPATCH_PROPERTYGET The member is retrieved as a property or data member.
DISPATCH_PROPERTYPUT The member is changed as a property or data member.
DISPATCH_PROPERTYPUTREF The member is changed by using a reference assignment, rather than a value assignment. This value is valid only when the property accepts a reference to an object.

For more information, see ITypeInfo::Invoke method.

Applies to