ITypeInfo.Invoke Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
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.