Microsoft SDK for Java

invoke

The invoke method of the Dispatch Class contains the following signatures:

invoke(Object pDispatch, _Guid iid, String dispName, int dispID, int lcid, int wFlags, Object oArg[], int uArgErr[])
invoke(Object pDispatch, String dispName, int wFlags, Object oArg[], int uArgErr[])
invoke(Object pDispatch, int dispid, int wFlags, Object oArg[], int uArgErr[])

invoke(Object pDispatch, _Guid iid, String dispName, int dispID, int lcid, int wFlags, Object oArg[], int uArgErr[])

Invokes a method or accesses a property on an ActiveX Automation object. This method is essentially a direct wrapper around the IDispatch::Invoke method. The difference between this method and invokev is that this method accepts arbitrary objects rather than Variant objects as arguments to the invoked method.

Syntax

public static Variant invoke(Object pDispatch, _Guid iid, String ispName, int dispID, int lcid, int wFlags, Object oArg[], int uArgErr[]);

Return Value

Returns the Variant object returned by the method or property access.

Parameters

pDispatch The Java proxy of the ActiveX Automation object.
iid The identifier of the interface that is called. If the value is null, defaults to IID_IDispatch.
dispName The name of the method or property that is invoked. If the value is null, dispID is used.
dispID The identifier of the method or property. Unless dispName is null, this parameter is ignored.
lcid The locale ID.
wFlags The type of access, which must be Dispatch.Method, Dispatch.Get, Dispatch.Put, or Dispatch.PutRef.
oArg The arguments of the method or property.
uArgErr An optional one-element array. If an error occurs, uArgErr receives the index of the offending parameter.

invoke(Object pDispatch, String dispName, int wFlags, Object oArg[], int uArgErr[])

Invokes a method or accesses a property on an ActiveX Automation object. This method is essentially a direct wrapper around the IDispatch::Invoke method. This method is easier to call than the full invokev method and enables you to pass arbitrary objects rather than Variants. However, the method does not enable you to specify the interface IID or the locale, and the method must be identified by name.

Syntax

public static Variant invoke(Object pDispatch, String dispName, int Flags, Object oArg[], int uArgErr[]);

Return Value

Returns the Variant returned by the method or property access.

Parameters

pDispatch The Java proxy of the ActiveX Automation object.
dispName The name of the method or property.
wFlags The type of access, which must be Dispatch.Method, Dispatch.Get, Dispatch.Put, or Dispatch.PutRef.
oArg The arguments of the method or property.
uArgErr An optional one-element array. If an error occurs, uArgErr receives the index of the offending parameter.

invoke(Object pDispatch, int dispid, int wFlags, Object oArg[], int uArgErr[])

Invokes a method or accesses a property on an ActiveX Automation object. This method is essentially a direct wrapper around the IDispatch::Invoke method. This method is easier to call than the full invokev method because it allows you to pass arbitrary objects rather than Variant objects. However, this method does not enable you to specify the interface IID or the locale, and the method must be identified by dispid.

Syntax

public static Variant invoke(Object pDispatch, int dispid, int wFlags, Object oArg[], int uArgErr[]);

Return Value

Returns the Variant object returned by the method or property access.

Parameters

pDispatch The Java proxy of the ActiveX Automation object.
dispid The identifier of the method or property.
wFlags The type of access, which must be Dispatch.Method, Dispatch.Get, Dispatch.Put, or Dispatch.PutRef.
oArg The arguments of the method or property.
uArgErr An optional one-element array. If an error occurs, uArgErr receives the index of the offending parameter.

© 1999 Microsoft Corporation. All rights reserved. Terms of use.